@egulatee/pulumi-stack-alias 0.2.0

package/dist/alias.d.ts

@@ -0,0 +1,104 @@
+import { AliasConfig, AliasExports, ConditionalAliasConfig } from "./types";
+/**
+ * Creates a stack alias that re-exports outputs from a target stack
+ *
+ * This is the core function of the Producer-Controlled Proxy pattern.
+ * It creates a StackReference to the target stack and re-exports specified outputs.
+ *
+ * @example
+ * ```typescript
+ * // In alias stack infrastructure/dev
+ * import { createStackAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createStackAlias({
+ *   targetProject: "infrastructure",
+ *   targetStack: "shared",
+ *   outputs: ["vpcId", "clusterName", "endpoint"]
+ * });
+ *
+ * export const vpcId = alias.vpcId;
+ * export const clusterName = alias.clusterName;
+ * export const endpoint = alias.endpoint;
+ * ```
+ *
+ * @param config - Alias configuration
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+export declare function createStackAlias(config: AliasConfig): AliasExports;
+/**
+ * Creates a conditional alias based on pattern matching
+ *
+ * Evaluates pattern rules in order and uses the first matching target.
+ * Falls back to defaultTarget if no pattern matches.
+ *
+ * @example
+ * ```typescript
+ * // In infrastructure/index.ts
+ * import { createConditionalAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createConditionalAlias({
+ *   targetProject: "infrastructure",
+ *   patterns: [
+ *     { pattern: "*\/prod", target: "prod" },
+ *     { pattern: "*\/staging", target: "shared" },
+ *     { pattern: "*\/*-ephemeral", target: "shared" }
+ *   ],
+ *   defaultTarget: "shared",
+ *   outputs: ["vpcId", "endpoint"]
+ * });
+ *
+ * export const vpcId = alias.vpcId;
+ * export const endpoint = alias.endpoint;
+ * ```
+ *
+ * @param config - Conditional alias configuration
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+export declare function createConditionalAlias(config: ConditionalAliasConfig): AliasExports;
+/**
+ * Creates a simple alias using a simplified API
+ *
+ * Convenience wrapper around createStackAlias for common use cases.
+ *
+ * @example
+ * ```typescript
+ * import { createSimpleAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createSimpleAlias("infrastructure", "shared", ["vpcId"]);
+ * export const vpcId = alias.vpcId;
+ * ```
+ *
+ * @param targetProject - Target project name
+ * @param targetStack - Target stack name
+ * @param outputs - List of output names to re-export
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+export declare function createSimpleAlias(targetProject: string, targetStack: string, outputs: string[]): AliasExports;
+/**
+ * Pattern matching with wildcard support
+ *
+ * Supports wildcards (*) in project and stack positions, as well as
+ * prefix and suffix wildcards.
+ *
+ * Pattern format: "projectPattern/stackPattern"
+ *
+ * Wildcard rules:
+ * - "*" matches any value
+ * - "*-suffix" matches any string ending with "-suffix"
+ * - "prefix-*" matches any string starting with "prefix-"
+ * - "exact" matches exactly "exact"
+ *
+ * @example
+ * ```typescript
+ * matchesPattern("myproject/*", "myproject", "dev") // true
+ * matchesPattern("*\/dev", "anyproject", "dev") // true
+ * matchesPattern("*\/*-dev", "app", "service-dev") // true
+ * ```
+ *
+ * @param pattern - Pattern string (e.g., "myproject/*", "*\/dev")
+ * @param project - Current project name to match against
+ * @param stack - Current stack name to match against
+ * @returns True if pattern matches the project/stack combination
+ */
+export declare function matchesPattern(pattern: string, project: string, stack: string): boolean;
+//# sourceMappingURL=alias.d.ts.map

package/dist/alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../src/alias.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAWlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,YAAY,CA0BnF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,GAChB,YAAY,CAEd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAavF"}

package/dist/alias.js

@@ -0,0 +1,215 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStackAlias = createStackAlias;
+exports.createConditionalAlias = createConditionalAlias;
+exports.createSimpleAlias = createSimpleAlias;
+exports.matchesPattern = matchesPattern;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+/**
+ * Creates a stack alias that re-exports outputs from a target stack
+ *
+ * This is the core function of the Producer-Controlled Proxy pattern.
+ * It creates a StackReference to the target stack and re-exports specified outputs.
+ *
+ * @example
+ * ```typescript
+ * // In alias stack infrastructure/dev
+ * import { createStackAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createStackAlias({
+ *   targetProject: "infrastructure",
+ *   targetStack: "shared",
+ *   outputs: ["vpcId", "clusterName", "endpoint"]
+ * });
+ *
+ * export const vpcId = alias.vpcId;
+ * export const clusterName = alias.clusterName;
+ * export const endpoint = alias.endpoint;
+ * ```
+ *
+ * @param config - Alias configuration
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+function createStackAlias(config) {
+    const org = config.targetOrg || pulumi.getOrganization();
+    const targetStackName = `${org}/${config.targetProject}/${config.targetStack}`;
+    const targetStack = new pulumi.StackReference(targetStackName);
+    const exports = {};
+    for (const outputName of config.outputs) {
+        exports[outputName] = targetStack.requireOutput(outputName);
+    }
+    return exports;
+}
+/**
+ * Creates a conditional alias based on pattern matching
+ *
+ * Evaluates pattern rules in order and uses the first matching target.
+ * Falls back to defaultTarget if no pattern matches.
+ *
+ * @example
+ * ```typescript
+ * // In infrastructure/index.ts
+ * import { createConditionalAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createConditionalAlias({
+ *   targetProject: "infrastructure",
+ *   patterns: [
+ *     { pattern: "*\/prod", target: "prod" },
+ *     { pattern: "*\/staging", target: "shared" },
+ *     { pattern: "*\/*-ephemeral", target: "shared" }
+ *   ],
+ *   defaultTarget: "shared",
+ *   outputs: ["vpcId", "endpoint"]
+ * });
+ *
+ * export const vpcId = alias.vpcId;
+ * export const endpoint = alias.endpoint;
+ * ```
+ *
+ * @param config - Conditional alias configuration
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+function createConditionalAlias(config) {
+    const currentProject = pulumi.getProject();
+    const currentStack = pulumi.getStack();
+    // Find first matching pattern
+    let targetStack = config.defaultTarget;
+    for (const rule of config.patterns) {
+        if (matchesPattern(rule.pattern, currentProject, currentStack)) {
+            targetStack = rule.target;
+            break;
+        }
+    }
+    if (!targetStack) {
+        throw new Error(`No matching pattern found for ${currentProject}/${currentStack} ` +
+            `and no defaultTarget specified.`);
+    }
+    return createStackAlias({
+        targetProject: config.targetProject,
+        targetStack: targetStack,
+        targetOrg: config.targetOrg,
+        outputs: config.outputs,
+    });
+}
+/**
+ * Creates a simple alias using a simplified API
+ *
+ * Convenience wrapper around createStackAlias for common use cases.
+ *
+ * @example
+ * ```typescript
+ * import { createSimpleAlias } from "@egulatee/pulumi-stack-alias";
+ *
+ * const alias = createSimpleAlias("infrastructure", "shared", ["vpcId"]);
+ * export const vpcId = alias.vpcId;
+ * ```
+ *
+ * @param targetProject - Target project name
+ * @param targetStack - Target stack name
+ * @param outputs - List of output names to re-export
+ * @returns Record of Pulumi Outputs for each specified output name
+ */
+function createSimpleAlias(targetProject, targetStack, outputs) {
+    return createStackAlias({ targetProject, targetStack, outputs });
+}
+/**
+ * Pattern matching with wildcard support
+ *
+ * Supports wildcards (*) in project and stack positions, as well as
+ * prefix and suffix wildcards.
+ *
+ * Pattern format: "projectPattern/stackPattern"
+ *
+ * Wildcard rules:
+ * - "*" matches any value
+ * - "*-suffix" matches any string ending with "-suffix"
+ * - "prefix-*" matches any string starting with "prefix-"
+ * - "exact" matches exactly "exact"
+ *
+ * @example
+ * ```typescript
+ * matchesPattern("myproject/*", "myproject", "dev") // true
+ * matchesPattern("*\/dev", "anyproject", "dev") // true
+ * matchesPattern("*\/*-dev", "app", "service-dev") // true
+ * ```
+ *
+ * @param pattern - Pattern string (e.g., "myproject/*", "*\/dev")
+ * @param project - Current project name to match against
+ * @param stack - Current stack name to match against
+ * @returns True if pattern matches the project/stack combination
+ */
+function matchesPattern(pattern, project, stack) {
+    const [projectPattern, stackPattern] = pattern.split("/");
+    if (!projectPattern || !stackPattern) {
+        throw new Error(`Invalid pattern format: "${pattern}". Expected "projectPattern/stackPattern".`);
+    }
+    const projectMatches = matchesWildcard(projectPattern, project);
+    const stackMatches = matchesWildcard(stackPattern, stack);
+    return projectMatches && stackMatches;
+}
+/**
+ * Wildcard matching for a single component
+ *
+ * Supports:
+ * - "*" matches anything
+ * - "*-suffix" matches strings ending with suffix
+ * - "prefix-*" matches strings starting with prefix
+ * - "exact" matches exactly
+ *
+ * @internal
+ * @param pattern - Pattern string (may contain wildcards)
+ * @param value - Value to match against pattern
+ * @returns True if value matches pattern
+ */
+function matchesWildcard(pattern, value) {
+    // Exact wildcard - matches anything
+    if (pattern === "*") {
+        return true;
+    }
+    // Suffix wildcard: *-dev matches foo-dev, bar-dev
+    if (pattern.startsWith("*")) {
+        const suffix = pattern.substring(1);
+        return value.endsWith(suffix);
+    }
+    // Prefix wildcard: prod-* matches prod-us, prod-eu
+    if (pattern.endsWith("*")) {
+        const prefix = pattern.substring(0, pattern.length - 1);
+        return value.startsWith(prefix);
+    }
+    // Exact match
+    return pattern === value;
+}
+//# sourceMappingURL=alias.js.map

package/dist/alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.js","sourceRoot":"","sources":["../src/alias.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @egulatee/pulumi-stack-alias
+ *
+ * Producer-side stack aliasing for Pulumi using lightweight proxy stacks.
+ *
+ * Consumers use standard StackReference (no library dependency).
+ * Producers use this library to create alias stacks that re-export outputs.
+ *
+ * ## Producer-Controlled Proxy Pattern
+ *
+ * Alias stacks re-export outputs from canonical stacks. Consumers use standard
+ * Pulumi StackReference without any library dependency. Producers use this
+ * library to create proxy stacks that keep outputs in sync.
+ *
+ * @packageDocumentation
+ */
+export { createStackAlias, createConditionalAlias, createSimpleAlias, matchesPattern, } from "./alias";
+export type { AliasConfig, AliasExports, PatternRule, ConditionalAliasConfig, } from "./types";
+export { Output, StackReference } from "@pulumi/pulumi";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @egulatee/pulumi-stack-alias
+ *
+ * Producer-side stack aliasing for Pulumi using lightweight proxy stacks.
+ *
+ * Consumers use standard StackReference (no library dependency).
+ * Producers use this library to create alias stacks that re-export outputs.
+ *
+ * ## Producer-Controlled Proxy Pattern
+ *
+ * Alias stacks re-export outputs from canonical stacks. Consumers use standard
+ * Pulumi StackReference without any library dependency. Producers use this
+ * library to create proxy stacks that keep outputs in sync.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StackReference = exports.Output = exports.matchesPattern = exports.createSimpleAlias = exports.createConditionalAlias = exports.createStackAlias = void 0;
+var alias_1 = require("./alias");
+Object.defineProperty(exports, "createStackAlias", { enumerable: true, get: function () { return alias_1.createStackAlias; } });
+Object.defineProperty(exports, "createConditionalAlias", { enumerable: true, get: function () { return alias_1.createConditionalAlias; } });
+Object.defineProperty(exports, "createSimpleAlias", { enumerable: true, get: function () { return alias_1.createSimpleAlias; } });
+Object.defineProperty(exports, "matchesPattern", { enumerable: true, get: function () { return alias_1.matchesPattern; } });
+// Re-export Pulumi types for convenience
+var pulumi_1 = require("@pulumi/pulumi");
+Object.defineProperty(exports, "Output", { enumerable: true, get: function () { return pulumi_1.Output; } });
+Object.defineProperty(exports, "StackReference", { enumerable: true, get: function () { return pulumi_1.StackReference; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,iCAKiB;AAJf,yGAAA,gBAAgB,OAAA;AAChB,+GAAA,sBAAsB,OAAA;AACtB,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AAUhB,yCAAyC;AACzC,yCAAwD;AAA/C,gGAAA,MAAM,OAAA;AAAE,wGAAA,cAAc,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,66 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * Configuration for creating a stack alias
+ */
+export interface AliasConfig {
+    /**
+     * Target organization name (defaults to current organization)
+     */
+    targetOrg?: string;
+    /**
+     * Target project name
+     */
+    targetProject: string;
+    /**
+     * Target stack name
+     */
+    targetStack: string;
+    /**
+     * List of output names to re-export from the target stack
+     */
+    outputs: string[];
+}
+/**
+ * Record of aliased outputs (all are Pulumi Outputs)
+ */
+export type AliasExports = Record<string, pulumi.Output<any>>;
+/**
+ * A pattern rule for conditional aliasing
+ */
+export interface PatternRule {
+    /**
+     * Pattern in format "project/stack" with wildcard support
+     * Examples: "* /prod", "myproject/ *", "* / *-ephemeral" (without spaces)
+     */
+    pattern: string;
+    /**
+     * Target stack name to use when this pattern matches
+     */
+    target: string;
+}
+/**
+ * Configuration for creating a conditional alias based on pattern matching
+ */
+export interface ConditionalAliasConfig {
+    /**
+     * Target project name
+     */
+    targetProject: string;
+    /**
+     * Target organization name (defaults to current organization)
+     */
+    targetOrg?: string;
+    /**
+     * List of pattern rules (evaluated in order, first match wins)
+     */
+    patterns: PatternRule[];
+    /**
+     * Default target stack if no pattern matches (optional)
+     */
+    defaultTarget?: string;
+    /**
+     * List of output names to re-export from the target stack
+     */
+    outputs: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/README.md

@@ -0,0 +1,67 @@
+# Examples
+
+This directory contains example implementations of stack aliasing patterns.
+
+## Simple Alias
+
+The `simple-alias` example shows the most basic usage:
+- Create an alias stack that redirects to a canonical stack
+- Re-export specific outputs
+
+**Usage:**
+```typescript
+import { createStackAlias } from "@egulatee/pulumi-stack-alias";
+
+const alias = createStackAlias({
+  targetProject: "infrastructure",
+  targetStack: "shared",
+  outputs: ["vpcId", "endpoint"],
+});
+
+export const vpcId = alias.vpcId;
+```
+
+## Conditional Alias
+
+The `conditional-alias` example demonstrates:
+- Using stack configuration to determine behavior
+- Same code handles both alias and canonical stacks
+- Config-driven stack behavior
+
+**Usage:**
+```typescript
+const config = new pulumi.Config();
+const aliasTarget = config.get("aliasTarget");
+
+if (aliasTarget) {
+  // Alias stack - redirect
+  const alias = createStackAlias({ ... });
+} else {
+  // Canonical stack - create resources
+  export const vpcId = /* actual resources */;
+}
+```
+
+## Running Examples
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Navigate to an example:
+   ```bash
+   cd examples/simple-alias
+   ```
+
+3. Initialize stacks:
+   ```bash
+   pulumi stack init shared
+   pulumi stack init dev
+   ```
+
+4. Deploy:
+   ```bash
+   pulumi up --stack shared  # Deploy canonical stack first
+   pulumi up --stack dev     # Deploy alias stack
+   ```

package/examples/conditional-alias/Pulumi.dev.yaml

@@ -0,0 +1,2 @@
+config:
+  infrastructure:aliasTarget: shared  # dev aliases to shared

package/examples/conditional-alias/Pulumi.shared.yaml

@@ -0,0 +1,2 @@
+config:
+  # No aliasTarget = this is the canonical stack with actual resources

package/examples/conditional-alias/Pulumi.staging.yaml

@@ -0,0 +1,2 @@
+config:
+  infrastructure:aliasTarget: shared  # staging aliases to shared

package/examples/conditional-alias/Pulumi.yaml

@@ -0,0 +1,4 @@
+name: infrastructure
+description: Conditional alias example with environment detection
+runtime:
+  name: nodejs

package/examples/conditional-alias/index.ts

@@ -0,0 +1,30 @@
+import { createConditionalAlias } from "@egulatee/pulumi-stack-alias";
+
+/**
+ * Conditional alias example using pattern matching
+ *
+ * This example demonstrates how to use createConditionalAlias to automatically
+ * route different stacks to appropriate canonical stacks based on patterns.
+ *
+ * Pattern matching rules:
+ * - prod stacks -> infrastructure/prod
+ * - staging stacks -> infrastructure/shared
+ * - dev stacks -> infrastructure/shared
+ * - *-ephemeral stacks -> infrastructure/shared
+ */
+
+const alias = createConditionalAlias({
+  targetProject: "infrastructure",
+  patterns: [
+    { pattern: "*/prod", target: "prod" },
+    { pattern: "*/staging", target: "shared" },
+    { pattern: "*/dev", target: "shared" },
+    { pattern: "*/*-ephemeral", target: "shared" },
+  ],
+  defaultTarget: "shared",
+  outputs: ["vpcId", "endpoint", "clusterName"],
+});
+
+export const vpcId = alias.vpcId;
+export const endpoint = alias.endpoint;
+export const clusterName = alias.clusterName;

package/examples/simple-alias/Pulumi.dev.yaml

@@ -0,0 +1,4 @@
+config:
+  # This configures the dev stack to be an alias
+  infrastructure:aliasTarget: shared
+  infrastructure:aliasProject: infrastructure

package/examples/simple-alias/Pulumi.yaml

@@ -0,0 +1,4 @@
+name: infrastructure
+description: Example infrastructure project with stack aliasing
+runtime:
+  name: nodejs

package/examples/simple-alias/index.ts

@@ -0,0 +1,23 @@
+import { createStackAlias } from "@egulatee/pulumi-stack-alias";
+
+/**
+ * Simple alias example: infrastructure/dev → infrastructure/shared
+ *
+ * This stack acts as an alias that redirects to the canonical 'shared' stack.
+ * All outputs from the shared stack are re-exported here.
+ */
+
+const alias = createStackAlias({
+  targetProject: "infrastructure",
+  targetStack: "shared",
+  outputs: [
+    "vpcId",
+    "endpoint",
+    "clusterName",
+  ],
+});
+
+// Re-export all outputs
+export const vpcId = alias.vpcId;
+export const endpoint = alias.endpoint;
+export const clusterName = alias.clusterName;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@egulatee/pulumi-stack-alias",
+  "version": "0.2.0",
+  "description": "Producer-side stack aliasing for Pulumi using lightweight proxy stacks",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pulumi",
+    "infrastructure-as-code",
+    "stack-alias",
+    "stack-reference",
+    "devops",
+    "multi-environment"
+  ],
+  "author": "Eric Gulatee",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/egulatee/pulumi-stack-alias.git"
+  },
+  "bugs": {
+    "url": "https://github.com/egulatee/pulumi-stack-alias/issues"
+  },
+  "homepage": "https://github.com/egulatee/pulumi-stack-alias#readme",
+  "peerDependencies": {
+    "@pulumi/pulumi": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}