@webstir-io/webstir-backend 0.1.15

package/scripts/update-contract.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage: scripts/update-contract.sh [x.y.z|--latest] [--exact] [--fast]
+
+Updates @webstir-io/module-contract (defaults to latest when no version is provided),
+installs deps, then builds and tests the backend package. Does NOT publish. If
+everything passes, run scripts/publish.sh <bump> separately.
+
+Examples:
+  scripts/update-contract.sh                # use latest
+  scripts/update-contract.sh --latest       # explicit latest
+  scripts/update-contract.sh 0.1.8          # specific version (caret range)
+  scripts/update-contract.sh 0.1.8 --exact  # set exact version instead of ^range
+  scripts/update-contract.sh 0.1.8 --fast   # lockfile-only update; skip build/test
+EOF
+  exit 1
+}
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+has_script() {
+  local script_name="$1"
+  node -e "const fs=require('fs'); const pkg=JSON.parse(fs.readFileSync('package.json','utf8')); const has=!!(pkg.scripts && Object.prototype.hasOwnProperty.call(pkg.scripts, '${script_name}')); process.exit(has ? 0 : 1);"
+}
+
+main() {
+  local ver=""
+  local exact="false"
+  local fast="false"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --latest)
+        ver="__resolve_latest__"
+        ;;
+      --exact)
+        exact="true"
+        ;;
+      --fast)
+        fast="true"
+        ;;
+      -h|--help)
+        usage ;;
+      *)
+        # assume explicit version
+        if [[ -n "$ver" && "$ver" != "__resolve_latest__" ]]; then
+          echo "error: duplicate version argument '$1'" >&2
+          usage
+        fi
+        ver="$1"
+        ;;
+    esac
+    shift || true
+  done
+
+  # Default to latest if no version provided
+  if [[ -z "$ver" || "$ver" == "__resolve_latest__" ]]; then
+    echo "› Resolving latest @webstir-io/module-contract version"
+    ver="$(npm view @webstir-io/module-contract version 2>/dev/null || true)"
+    if [[ -z "$ver" ]]; then
+      echo "error: unable to resolve latest @webstir-io/module-contract version" >&2
+      exit 1
+    fi
+  fi
+
+  if [[ ! $ver =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    echo "error: invalid version '$ver' (expected x.y.z)" >&2
+    usage
+  fi
+
+  cd "$ROOT_DIR"
+
+  local spec
+  if [[ "$exact" == "true" ]]; then
+    spec="$ver"
+  else
+    spec="^$ver"
+  fi
+
+  echo "› Setting @webstir-io/module-contract to $spec"
+  npm pkg set "dependencies.@webstir-io/module-contract=$spec"
+
+  echo "› npm install (refresh lockfile)"
+  if [[ "$fast" == "true" ]]; then
+    npm install --package-lock-only --no-audit --no-fund --ignore-scripts
+  else
+    npm install --no-audit --no-fund
+  fi
+
+  # Clarify versions in logs to avoid confusion with backend package version
+  local backend_ver
+  backend_ver="$(node -p "require('./package.json').version" 2>/dev/null || echo 'unknown')"
+  local installed_contract
+  installed_contract="$(npm ls @webstir-io/module-contract --json 2>/dev/null | node -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{try{const j=JSON.parse(d);const v=(j.dependencies&&j.dependencies['@webstir-io/module-contract']&&j.dependencies['@webstir-io/module-contract'].version)||'';console.log(v||'unknown')}catch{console.log('unknown')}})")"
+  echo "› Backend package: @webstir-io/webstir-backend@${backend_ver}"
+  echo "› Contract installed: @webstir-io/module-contract@${installed_contract}"
+
+  if [[ "$fast" != "true" ]]; then
+    echo "› npm run build"
+    npm run build
+
+    if has_script test; then
+      echo "› npm test"
+      npm test
+    fi
+
+    if has_script smoke; then
+      echo "› npm run smoke"
+      npm run smoke
+    fi
+  fi
+
+  echo
+  echo "Contract update complete: @webstir-io/module-contract@$spec"
+}
+
+main "$@"

package/src/build/artifacts.ts

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+
+import { glob } from 'glob';
+import type { ModuleArtifact, ModuleDiagnostic, ModuleManifest } from '@webstir-io/module-contract';
+
+import { pushEntryBucketSummary } from '../diagnostics/summary.js';
+
+export async function collectArtifacts(buildRoot: string, includeSourceMaps: boolean): Promise<ModuleArtifact[]> {
+    const patterns = ['**/*.js'];
+    if (includeSourceMaps) {
+        patterns.push('**/*.js.map');
+    }
+    const matches = new Set<string>();
+    for (const pattern of patterns) {
+        const files = await glob(pattern, {
+            cwd: buildRoot,
+            nodir: true,
+            dot: false
+        });
+        for (const relativePath of files) {
+            matches.add(relativePath);
+        }
+    }
+
+    return Array.from(matches).map<ModuleArtifact>((relativePath) => ({
+        path: path.join(buildRoot, relativePath),
+        type: relativePath.endsWith('.map') ? 'asset' : 'bundle'
+    }));
+}
+
+export function createBuildManifest(
+    buildRoot: string,
+    artifacts: readonly ModuleArtifact[],
+    diagnostics: ModuleDiagnostic[],
+    moduleManifest: ModuleManifest
+) {
+    const entryPoints: string[] = [];
+
+    for (const artifact of artifacts) {
+        const relative = path.relative(buildRoot, artifact.path);
+        if (relative.endsWith('index.js')) {
+            entryPoints.push(relative);
+        }
+    }
+
+    if (entryPoints.length === 0) {
+        const defaultEntry = path.join(buildRoot, 'index.js');
+        if (existsSync(defaultEntry)) {
+            entryPoints.push(path.relative(buildRoot, defaultEntry));
+        } else {
+            diagnostics.push({
+                severity: 'warn',
+                message: 'No backend entry point found (expected index.js).'
+            });
+        }
+    }
+
+    pushEntryBucketSummary(diagnostics, entryPoints);
+
+    return {
+        entryPoints,
+        staticAssets: [],
+        diagnostics,
+        module: moduleManifest
+    };
+}

package/src/build/entries.ts

@@ -0,0 +1,19 @@
+import path from 'node:path';
+
+import { glob } from 'glob';
+
+export async function discoverEntryPoints(sourceRoot: string): Promise<string[]> {
+    const patterns = [
+        'index.{ts,tsx,js,mjs}',
+        'functions/*/index.{ts,tsx,js,mjs}',
+        'jobs/*/index.{ts,tsx,js,mjs}'
+    ];
+    const entries = new Set<string>();
+    for (const pattern of patterns) {
+        const matches = await glob(pattern, { cwd: sourceRoot, nodir: true, dot: false });
+        for (const rel of matches) {
+            entries.add(path.join(sourceRoot, rel));
+        }
+    }
+    return Array.from(entries);
+}