@jahands/dagger-helpers 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jacob Hands
+
+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/README.md

@@ -0,0 +1,3 @@
+# @jahands/dagger-helpers
+
+dagger.io helpers for my own projects - not meant for public use

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/** various constants for dagger modules in my repos */
+export declare const constants: {
+    /** constants for workers-monorepo */
+    readonly workersMonorepo: {
+        /** default source ignore list */
+        readonly ignore: string[];
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,SAAS;IACrB,qCAAqC;;QAEpC,iCAAiC;;;CAiBzB,CAAA"}

package/dist/constants.js

@@ -0,0 +1,23 @@
+/** various constants for dagger modules in my repos */
+export const constants = {
+    /** constants for workers-monorepo */
+    workersMonorepo: {
+        /** default source ignore list */
+        ignore: [
+            '**/node_modules/',
+            '**/.env',
+            '**/.secret',
+            '**/Earthfile',
+            '**/.wrangler',
+            '**/.dev.vars',
+            '**/.turbo/',
+            '**/dist/',
+            '**/dist2/',
+            '**/.DS_Store',
+            '**/.astro/',
+            '**/.next/',
+            '*.env',
+        ],
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,CAAC,MAAM,SAAS,GAAG;IACxB,qCAAqC;IACrC,eAAe,EAAE;QAChB,iCAAiC;QACjC,MAAM,EAAE;YACP,kBAAkB;YAClB,SAAS;YACT,YAAY;YACZ,cAAc;YACd,cAAc;YACd,cAAc;YACd,YAAY;YACZ,UAAU;YACV,WAAW;YACX,cAAc;YACd,YAAY;YACZ,WAAW;YACX,OAAO;SACY;KACpB;CACQ,CAAA"}

package/dist/env.d.ts

@@ -0,0 +1,26 @@
+import type { Secret } from '@dagger.io/dagger';
+/**
+ * Structure stored in AsyncLocalStorage, containing both the fully merged
+ * environment variables and the set of variables explicitly passed to the
+ * current decorated function call.
+ */
+export interface EnvContext {
+    currentParams: Set<string>;
+    mergedEnv: Record<string, Secret | string | undefined>;
+}
+/**
+ * Store for environment variables accessible via AsyncLocalStorage
+ */
+export declare const envStorage: any;
+/**
+ * Helper to extract parameter names from a function's source code.
+ * Note: This approach using Function.toString() can be fragile and might
+ * break with code minification or complex function definitions.
+ */
+export declare function extractParamNames(func: Function): string[];
+/**
+ * Decorator factory that wraps a method to capture its arguments based on
+ * extracted parameter names and store them in AsyncLocalStorage.
+ */
+export declare function ParamsToEnv(): MethodDecorator;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,KAAsC,CAAA;AAE7D;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA8B1D;AAED;;;GAGG;AAEH,wBAAgB,WAAW,IAAI,eAAe,CA6D7C"}

package/dist/env.js

@@ -0,0 +1,95 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/**
+ * Store for environment variables accessible via AsyncLocalStorage
+ */
+export const envStorage = new AsyncLocalStorage();
+/**
+ * Helper to extract parameter names from a function's source code.
+ * Note: This approach using Function.toString() can be fragile and might
+ * break with code minification or complex function definitions.
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function extractParamNames(func) {
+    const funcStr = func.toString().replace(/(\r\n|\n|\r)/gm, '');
+    // Regex to find parameter list within parentheses, handles various function definition styles
+    const paramsMatch = funcStr.match(/(?:async\s*)?(?:function\s*[\w\s]*)?\(([^)]*)\)/) ??
+        funcStr.match(/^\s*(?:async\s*)?\(([^)]*)\)/); // Arrow function support
+    if (!paramsMatch || typeof paramsMatch[1] === 'undefined') {
+        console.warn('Could not extract parameter names from function string:', funcStr);
+        return [];
+    }
+    const paramsStr = paramsMatch[1];
+    // Remove comments, default values, and type annotations to isolate names
+    const cleanedParamsStr = paramsStr
+        .replace(/\/\*.*?\*\//g, '') // Remove block comments
+        .replace(/\/\/.*?$/gm, ''); // Remove line comments
+    if (!cleanedParamsStr.trim()) {
+        return []; // No parameters
+    }
+    return cleanedParamsStr
+        .split(',')
+        .map((param) => {
+        // Remove type annotations (e.g., ": Secret") and default initializers (e.g., "= 'default'")
+        const namePart = param.split(/[:=]/)[0];
+        return namePart?.trim() ?? '';
+    })
+        .filter((name) => name.length > 0); // Filter out empty strings from trailing commas etc.
+}
+/**
+ * Decorator factory that wraps a method to capture its arguments based on
+ * extracted parameter names and store them in AsyncLocalStorage.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export function ParamsToEnv() {
+    return function (_target, propertyKey, descriptor) {
+        if (typeof descriptor === 'undefined' || typeof descriptor.value !== 'function') {
+            throw new Error(`@ParamsToEnv decorator can only be applied to methods, not: ${String(propertyKey)}`);
+        }
+        const originalMethod = descriptor.value;
+        let paramNames = null; // Cache parameter names lazily
+        descriptor.value = function (...args) {
+            const parentContext = envStorage.getStore();
+            if (paramNames === null) {
+                paramNames = extractParamNames(originalMethod);
+                // Basic validation: Check if the number of extracted names matches the number of arguments received.
+                // This might be inaccurate if optional parameters aren't passed.
+                if (paramNames.length !== args.length && typeof propertyKey === 'string') {
+                    // Log a warning but attempt to proceed. The context might be incomplete.
+                    console.warn(`Parameter name extraction/argument count mismatch for ${propertyKey}: ` +
+                        `Extracted ${paramNames.length} names (${paramNames.join(', ')}), received ${args.length} args. ` +
+                        `Context in AsyncLocalStorage may be incomplete or incorrect.`);
+                    // Optionally, you could try to pad paramNames or truncate args, but it's risky.
+                }
+            }
+            const newEnv = {};
+            const currentParams = new Set(); // Track params for current method
+            paramNames?.forEach((name, index) => {
+                // Check if the param name matches the ENV_VAR pattern
+                if (/^[A-Z0-9_]+$/.test(name)) {
+                    // Add all matching defined parameter names to currentParams
+                    currentParams.add(name);
+                    // Only add to newEnv if argument was actually passed
+                    if (index < args.length) {
+                        newEnv[name] = args[index];
+                    }
+                }
+                // If paramNames.length > args.length, some names won't get a value, which is expected for optional params.
+            });
+            // merge parent context with new context (new takes precedence)
+            const parentMergedEnv = parentContext?.mergedEnv ?? {};
+            const mergedEnv = { ...parentMergedEnv, ...newEnv };
+            // Prepare context object for storage
+            const contextToStore = {
+                currentParams,
+                mergedEnv,
+            };
+            // run the original method within the AsyncLocalStorage context using the merged env
+            return envStorage.run(contextToStore, () => {
+                // The original method is called with its original arguments
+                return originalMethod.apply(this, args);
+            });
+        };
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ParamsToEnv, envStorage } from './env.js';
+export type { EnvContext } from './env.js';
+export { constants } from './constants.js';
+//# 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,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ParamsToEnv, envStorage } from './env.js';
+export { constants } from './constants.js';
+//# 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,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@jahands/dagger-helpers",
+  "version": "0.2.0",
+  "private": false,
+  "description": "dagger.io helpers for my own projects - not meant for public use",
+  "keywords": [
+    "dagger",
+    "dagger.io"
+  ],
+  "homepage": "https://github.com/jahands/workers-packages/tree/main/packages/dagger-helpers",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jahands/workers-packages.git",
+    "directory": "packages/dagger-helpers"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Jacob Hands",
+    "url": "https://github.com/jahands"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "5.5.4",
+    "vitest": "2.1.1",
+    "@repo/tools": "0.8.1",
+    "@repo/typescript-config": "0.3.4"
+  },
+  "peerDependencies": {
+    "@dagger.io/dagger": "^0.18.4"
+  },
+  "scripts": {
+    "build": "runx build tsc ./src/index.ts",
+    "check:lint": "run-eslint-workers",
+    "check:types": "runx check --exports",
+    "test": "run-vitest"
+  }
+}