@quiltdata/benchling-webhook 0.7.4-20251107T155705Z → 0.7.4

package/dist/scripts/list-quilt-stacks.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env ts-node
+/**
+ * List CloudFormation stacks that are Quilt catalog deployments
+ *
+ * Quilt stacks are identified by having a "QuiltWebHost" output parameter.
+ * This script efficiently fetches all stacks and filters them client-side.
+ */
+import { QuiltStack } from "../lib/utils/stack-inference";
+/**
+ * Find all Quilt stacks in a region with optional verbose output
+ */
+declare function findQuiltStacks(region: string, verbose?: boolean): Promise<QuiltStack[]>;
+export { findQuiltStacks };
+//# sourceMappingURL=list-quilt-stacks.d.ts.map

package/dist/scripts/list-quilt-stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-quilt-stacks.d.ts","sourceRoot":"","sources":["../../scripts/list-quilt-stacks.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAIH,UAAU,EACb,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,iBAAe,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBrF;AAkED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/scripts/list-quilt-stacks.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * List CloudFormation stacks that are Quilt catalog deployments
+ *
+ * Quilt stacks are identified by having a "QuiltWebHost" output parameter.
+ * This script efficiently fetches all stacks and filters them client-side.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findQuiltStacks = findQuiltStacks;
+const stack_inference_1 = require("../lib/utils/stack-inference");
+/**
+ * Find all Quilt stacks in a region with optional verbose output
+ */
+async function findQuiltStacks(region, verbose = false) {
+    if (verbose) {
+        console.log(`Searching for Quilt stacks in ${region}...`);
+        console.log();
+    }
+    // Get all stacks
+    const allStacks = (0, stack_inference_1.listAllStacks)(region);
+    if (verbose) {
+        console.log(`Found ${allStacks.length} total stacks`);
+        // Show progress for each stack
+        for (const stackSummary of allStacks) {
+            process.stdout.write(`  Checking ${stackSummary.StackName}...`);
+            if ((0, stack_inference_1.isQuiltStack)(region, stackSummary.StackName)) {
+                console.log(" ✓ Quilt stack");
+            }
+            else {
+                console.log(" (not Quilt)");
+            }
+        }
+    }
+    // Use the utility function to get all Quilt stacks
+    return (0, stack_inference_1.findAllQuiltStacks)(region, false);
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    const region = args.find(arg => arg.startsWith("--region="))?.split("=")[1] || "us-east-1";
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const json = args.includes("--json");
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ts-node scripts/list-quilt-stacks.ts [options]
+
+Options:
+  --region=REGION    AWS region to search (default: us-east-1)
+  --verbose, -v      Show detailed progress
+  --json             Output results as JSON
+  --help, -h         Show this help message
+
+Examples:
+  ts-node scripts/list-quilt-stacks.ts --region=us-east-1
+  ts-node scripts/list-quilt-stacks.ts --region=us-east-2 --verbose
+  ts-node scripts/list-quilt-stacks.ts --json
+`);
+        process.exit(0);
+    }
+    try {
+        const quiltStacks = await findQuiltStacks(region, verbose);
+        if (json) {
+            console.log(JSON.stringify(quiltStacks, null, 2));
+        }
+        else {
+            if (verbose) {
+                console.log();
+            }
+            console.log(`Found ${quiltStacks.length} Quilt stack(s) in ${region}:`);
+            console.log();
+            for (const stack of quiltStacks) {
+                console.log(`  • ${stack.StackName} (${stack.StackStatus})`);
+                const quiltWebHost = stack.Outputs?.find(o => o.OutputKey === "QuiltWebHost");
+                if (quiltWebHost) {
+                    console.log(`    QuiltWebHost: ${quiltWebHost.OutputValue}`);
+                }
+                const queueUrl = stack.Outputs?.find(o => o.OutputKey === "PackagerQueueUrl");
+                if (queueUrl) {
+                    console.log(`    Queue: ${queueUrl.OutputValue}`);
+                }
+                console.log();
+            }
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=list-quilt-stacks.js.map

package/dist/scripts/list-quilt-stacks.js.map

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

package/env.template

@@ -0,0 +1,79 @@
+#
+# ALWAYS REQUIRED PARAMETERS
+#
+
+# --- Benchling OAuth Configuration ---
+# Tenant: Use XXX if you login at XXX.benchling.com
+BENCHLING_TENANT=your-tenant
+
+# OAuth credentials from your Benchling app
+BENCHLING_CLIENT_ID=your-client-id
+BENCHLING_CLIENT_SECRET=your-client-secret
+
+# App definition ID from Benchling app manifest
+BENCHLING_APP_DEFINITION_ID=appdef_your_id_here
+
+# S3 bucket for storing Benchling exports (YOUR data bucket)
+BENCHLING_PKG_BUCKET=your-data-bucket # (without s3:// prefix)
+
+#
+# POSSIBLY REQUIRED PARAMETERS
+#
+
+QUILT_CATALOG=quilt-stack.your-company.com
+# Required UNLESS available from 'quilt3 config'
+
+BENCHLING_TEST_ENTRY=etr_123456789
+# Actual entry ID from your tenant, needed to run integration tests
+
+#
+# Optional PARAMETERS
+#
+
+# --- Package Configuration ---
+# Prefix for Quilt package names (e.g., "benchling/my-experiment")
+BENCHLING_PKG_PREFIX=benchling
+
+# Metadata key to link Benchling entries to packages
+BENCHLING_PKG_KEY=experiment_id
+
+
+# --- Application Configuration (Required) ---
+# Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+BENCHLING_LOG_LEVEL=INFO
+
+# Enable/disable webhook signature verification (true/false)
+BENCHLING_ENABLE_WEBHOOK_VERIFICATION=true
+
+# Comma-separated list of allowed source IPs (leave empty to allow all)
+# Example: 34.216.192.90,34.217.183.162
+BENCHLING_WEBHOOK_ALLOW_LIST=
+
+# ==============================================================================
+# NOTES
+# ==============================================================================
+#
+# Quick Start:
+#   1. Copy this file to .env: cp env.template .env
+#   2. Fill in BENCHLING_* variables (section 2)
+#   3. Create secret: npm run config
+#   4. Fill in QuiltStackARN (section 1)
+#   5. Deploy: npm run deploy
+#
+# Configuration at Runtime:
+#   The deployed stack resolves ALL configuration from just 2 sources:
+#   - QuiltStackARN → gets Quilt catalog, database, SQS queue from CloudFormation
+#   - BenchlingSecret → gets all Benchling credentials and app config from Secrets Manager
+#
+#   No other environment variables are needed for production deployment.
+#
+# Local Development:
+#   For testing locally without AWS:
+#   - make -C docker run-local   (starts Flask with mocked AWS)
+#   - make -C docker test-local  (runs tests against local server)
+#
+# For More Information:
+#   - See docs/PARAMETERS.md for parameter reference
+#   - See README.md for complete setup guide
+#   - Run: npm run cli -- --help
+#

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@quiltdata/benchling-webhook",
-  "version": "0.7.4-20251107T155705Z",
+  "version": "0.7.4",
   "description": "AWS CDK deployment for Benchling webhook processing using Fargate - Deploy directly with npx",
   "main": "dist/lib/index.js",
   "types": "dist/lib/index.d.ts",
   "files": [
     "dist/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "env.template"
   ],
   "bin": {
     "benchling-webhook": "./dist/bin/cli.js"
@@ -36,7 +37,7 @@
     "test": "npm run build:typecheck && npm run test:ts && npm run test:python",
     "test:ci": "npm run build:typecheck && npm run test:ts",
     "test:dev": "make -C docker test-deployed-dev PROFILE=dev",
-    "test:local": "make -C docker build && make -C docker test-local PROFILE=dev",
+    "test:local": "make -C docker build && make -C docker test-local",
     "test:prod": "make -C docker test-deployed-prod",
     "test:python": "make -C docker test-unit",
     "test:ts": "cross-env NODE_ENV=test jest --maxWorkers=50%",

package/dist/bin/commands/config-show.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * Config Show Command
- *
- * Outputs the complete configuration for a profile as JSON.
- * This is used by Python code to avoid config logic duplication.
- */
-interface ConfigShowOptions {
-    profile?: string;
-    json?: boolean;
-}
-export declare function configShowCommand(options: ConfigShowOptions): Promise<void>;
-export {};
-//# sourceMappingURL=config-show.d.ts.map

package/dist/bin/commands/config-show.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-show.d.ts","sourceRoot":"","sources":["../../../bin/commands/config-show.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAIH,UAAU,iBAAiB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF"}

package/dist/bin/commands/config-show.js

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * Config Show Command
- *
- * Outputs the complete configuration for a profile as JSON.
- * This is used by Python code to avoid config logic duplication.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.configShowCommand = configShowCommand;
-const xdg_config_1 = require("../../lib/xdg-config");
-async function configShowCommand(options) {
-    const profile = options.profile || "default";
-    const xdg = new xdg_config_1.XDGConfig();
-    // Check if profile exists
-    if (!xdg.profileExists(profile)) {
-        throw new Error(`Profile does not exist: ${profile}`);
-    }
-    // Read the profile configuration
-    const config = xdg.readProfile(profile);
-    // Always output as JSON (for Python consumption)
-    console.log(JSON.stringify(config, null, 2));
-}
-//# sourceMappingURL=config-show.js.map

package/dist/bin/commands/config-show.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-show.js","sourceRoot":"","sources":["../../../bin/commands/config-show.ts"],"names":[],"mappings":";;AACA;;;;;GAKG;;AASH,8CAeC;AAtBD,qDAAiD;AAO1C,KAAK,UAAU,iBAAiB,CAAC,OAA0B;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IAE7C,MAAM,GAAG,GAAG,IAAI,sBAAS,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,iCAAiC;IACjC,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAExC,iDAAiD;IACjD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}