@memberjunction/dynamic-packages 0.0.0 → 6.1.0-edge.6

package/dist/process-id.js

@@ -0,0 +1,104 @@
+/**
+ * Process identity and prefix matching.
+ *
+ * Process IDs are hierarchical, colon-separated, lowercase strings: `mjapi`, `cli`,
+ * `cli:sync`, `cli:sync:push`, `mcp`. A pattern matches an ID when it equals the ID or names
+ * one of its ancestor segments — `cli:sync` matches `cli:sync:push` but not `cli:syncother`
+ * or `cli:migrate`. This is what lets a config author scope a package to "all of the CLI",
+ * "just mj sync", or exactly one command with the same field.
+ */
+/** Wildcard pattern that matches every process. */
+export const ANY_PROCESS = '*';
+/** Lowercases, trims, and collapses whitespace around the colon separators. */
+export function NormalizeProcessId(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .split(':')
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0)
+        .join(':');
+}
+/**
+ * Builds a CLI process ID from an oclif command ID. oclif reports IDs as either `sync:push`
+ * or `sync push` (with `topicSeparator: ' '`); both become `cli:sync:push`.
+ */
+export function CliProcessId(commandId) {
+    const normalized = NormalizeProcessId((commandId ?? '').replace(/\s+/g, ':'));
+    return normalized.length > 0 ? `cli:${normalized}` : 'cli';
+}
+/** True when `pattern` equals `processId` or is an ancestor prefix of it (segment-aware). */
+export function ProcessIdMatches(processId, pattern) {
+    const id = NormalizeProcessId(processId);
+    const pat = NormalizeProcessId(pattern);
+    if (pat === ANY_PROCESS) {
+        return true;
+    }
+    if (pat.length === 0 || id.length === 0) {
+        return false;
+    }
+    return id === pat || id.startsWith(`${pat}:`);
+}
+/**
+ * Evaluates an entry's `Processes` / `ExcludeProcesses` against a process ID.
+ * No `Processes` (or an empty list) means "everywhere"; `ExcludeProcesses` is applied after.
+ */
+export function MatchesProcess(processId, filter) {
+    const includes = (filter?.Processes ?? []).filter((p) => typeof p === 'string' && p.trim().length > 0);
+    const excludes = (filter?.ExcludeProcesses ?? []).filter((p) => typeof p === 'string' && p.trim().length > 0);
+    if (includes.length > 0 && !includes.some((p) => ProcessIdMatches(processId, p))) {
+        return false;
+    }
+    if (excludes.some((p) => ProcessIdMatches(processId, p))) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Picks the value of the most specific key in `map` that matches `processId`.
+ * `'cli:sync'` beats `'cli'` beats `'*'`. Returns `undefined` when nothing matches.
+ */
+export function ResolveMostSpecific(processId, map) {
+    if (!map) {
+        return undefined;
+    }
+    let bestKey;
+    let bestDepth = -1;
+    for (const key of Object.keys(map)) {
+        if (!ProcessIdMatches(processId, key)) {
+            continue;
+        }
+        const normalized = NormalizeProcessId(key);
+        const depth = normalized === ANY_PROCESS ? 0 : normalized.split(':').length;
+        if (depth > bestDepth) {
+            bestDepth = depth;
+            bestKey = key;
+        }
+    }
+    return bestKey === undefined ? undefined : map[bestKey];
+}
+/**
+ * Environment variable through which an OUTER host tells nested hosts which process they are
+ * running inside. The `mj` CLI's prerun hook sets it to its own ID (`cli:ai:agents:run`) before
+ * the command imports `@memberjunction/ai-cli` or `@memberjunction/testing-cli`; those packages'
+ * provider bootstraps then evaluate `Processes` / `ExcludeProcesses` / `policy` under the SAME
+ * ID instead of their standalone `ai-cli` / `testing-cli` identity. Without it, an entry an
+ * operator excluded from `cli` would be loaded by the nested host a moment later.
+ */
+export const DYNAMIC_PACKAGES_PROCESS_ENV_VAR = 'MJ_DYNAMIC_PACKAGES_PROCESS';
+/**
+ * The process ID a host should load under: the one an enclosing host published through
+ * {@link DYNAMIC_PACKAGES_PROCESS_ENV_VAR} when there is one, else the host's own default.
+ *
+ * @example
+ * ```ts
+ * // packages/AI/AICLI — `mj-ai` standalone loads as 'ai-cli'; under `mj ai …` it inherits 'cli:ai:…'
+ * await LoadDynamicPackages({ processId: EffectiveProcessId('ai-cli'), ... });
+ * ```
+ */
+export function EffectiveProcessId(hostDefault) {
+    const fromEnv = typeof process !== 'undefined' && process.env ? process.env[DYNAMIC_PACKAGES_PROCESS_ENV_VAR] : undefined;
+    const normalized = fromEnv ? NormalizeProcessId(fromEnv) : '';
+    return normalized.length > 0 ? normalized : NormalizeProcessId(hostDefault);
+}
+//# sourceMappingURL=process-id.js.map

package/dist/process-id.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Types for the process-agnostic dynamic package loader.
+ *
+ * A "dynamic package" is an npm package whose name is only known at runtime — it is named by
+ * configuration (`mj.config.cjs` `dynamicPackages.*[]`, written by `mj app install`; the
+ * host's `codeGeneration.packages`), or by an Open App's own `mj-app.json` when a process runs
+ * inside that app's repository. Importing one triggers its `@RegisterClass` decorators so the
+ * ClassFactory returns the app's entity/action/provider subclasses instead of base-class
+ * fallbacks. MJAPI has always done this at boot; every other MJ process (the CLI, MCP/A2A
+ * servers, test bootstraps, ad-hoc scripts) needs the same thing, which is why the loader lives
+ * in a package with no MJ runtime dependencies.
+ */
+/** Which package tier a process wants: server-side (Node) packages or client (browser) ones. */
+export type DynamicPackageTier = 'server' | 'client';
+/**
+ * Whether a process should load dynamic packages at all. `'none'` is the escape hatch for
+ * "raw" runs — restoring dumps, bulk ingestion, or diagnosing a package that breaks boot —
+ * where custom `Save()` logic and lifecycle hooks must NOT run.
+ */
+export type DynamicPackagesMode = 'load' | 'none';
+/**
+ * Where the resolved mode came from, highest precedence first:
+ * `MJ_DYNAMIC_PACKAGES` env var > programmatic option > `dynamicPackages.policy` > default.
+ */
+export type DynamicPackagesModeSource = 'env' | 'option' | 'policy' | 'default';
+/**
+ * One entry of `dynamicPackages.server[]` / `dynamicPackages.client[]` in mj.config.cjs.
+ * `PackageName`, `StartupExport`, `AppName` and `Enabled` are written by `mj app install`;
+ * `Processes` / `ExcludeProcesses` are hand-authored scoping (see {@link MatchesProcess}).
+ */
+export interface DynamicPackageEntry {
+    /** npm package name to import. */
+    PackageName: string;
+    /** Optional named export to invoke after import (a registration kicker). */
+    StartupExport?: string;
+    /** Open App name this package belongs to (for tracking / pruning). */
+    AppName?: string;
+    /** Whether this package should be loaded anywhere. Treated as enabled unless explicitly `false`. */
+    Enabled?: boolean;
+    /**
+     * Process IDs (or prefixes) this entry loads in. Omitted or empty = every process that asks
+     * for the entry's tier. `['cli:sync']` loads for `cli:sync:push` and `cli:sync:pull` only;
+     * `['mjapi', 'cli']` loads in the API and in every CLI command.
+     */
+    Processes?: string[];
+    /** Process IDs (or prefixes) this entry must NOT load in, evaluated after {@link Processes}. */
+    ExcludeProcesses?: string[];
+}
+/**
+ * The `dynamicPackages` section of mj.config.cjs as this loader reads it.
+ */
+export interface DynamicPackagesConfig {
+    server?: DynamicPackageEntry[];
+    client?: DynamicPackageEntry[];
+    /**
+     * Per-process on/off policy keyed by process ID or prefix, e.g. `{ 'cli:codegen': 'none' }`.
+     * The most specific matching key wins. Overridden by the `MJ_DYNAMIC_PACKAGES` env var and
+     * by a programmatic `mode` option.
+     */
+    policy?: Record<string, DynamicPackagesMode>;
+}
+/** Where a loadable entry was discovered. */
+export type DynamicPackageSource = 'config' | 'generated' | 'manifest';
+/** Where a manifest-sourced package's workspace member lives on disk (the app's own repository). */
+export interface WorkspaceHome {
+    /** Directory holding the app's `mj-app.json`. */
+    RepoDir: string;
+    /** `code.sourceDirectory` from the manifest (default `packages`), relative to {@link RepoDir}. */
+    SourceDirectory: string;
+}
+/** An entry the loader decided about, with its provenance. */
+export interface DiscoveredDynamicPackage {
+    Entry: DynamicPackageEntry;
+    Source: DynamicPackageSource;
+    /**
+     * Present only for `'manifest'` entries: lets the loader fall back to importing the
+     * workspace member by path when no resolution anchor can see it (pnpm strict layout).
+     */
+    WorkspaceHome?: WorkspaceHome;
+}
+/** A package the loader imported (and whose startup export, if any, it ran). */
+export interface LoadedDynamicPackage extends DiscoveredDynamicPackage {
+    /** The imported module namespace — hosts read conventions like `RESOLVER_PATHS` off it. */
+    Module: Record<string, unknown>;
+    /**
+     * True when `StartupExport` named a function and it was invoked by THIS call. False when the
+     * entry has no startup export, the named export is missing, or the package was already loaded
+     * earlier in this process (the module is still returned; the hook is not run twice).
+     */
+    RanStartupExport: boolean;
+}
+/** Why an entry was not loaded. */
+export type DynamicPackageSkipReason = 'disabled' | 'process-filter' | 'mode-none' | 'duplicate';
+export interface SkippedDynamicPackage extends DiscoveredDynamicPackage {
+    Reason: DynamicPackageSkipReason;
+}
+/** A package that resolved but failed while loading (its own error — never masked). */
+export interface FailedDynamicPackage extends DiscoveredDynamicPackage {
+    Error: unknown;
+}
+/** Logger seam so each host routes loader output through its own channel (stdout, stderr, spinner). */
+export interface DynamicPackagesLogger {
+    /** Normal progress ("Loaded …"). */
+    info(message: string): void;
+    /** Recoverable problems the operator must see (a package that threw while loading). */
+    warn(message: string, error?: unknown): void;
+    /** Detail that only matters when debugging (skips, filters, mode source). */
+    verbose?(message: string): void;
+}
+export interface LoadDynamicPackagesOptions {
+    /**
+     * Identity of the calling process, lowercase and colon-separated: `mjapi`, `cli:sync:push`,
+     * `mcp`, `a2a`, `integration-tests`. Entry `Processes` / `ExcludeProcesses` and
+     * `dynamicPackages.policy` match against it by exact ID or by prefix segment.
+     */
+    processId: string;
+    /** Raw (un-validated) mj.config.cjs object. Zod-parsed configs usually strip `dynamicPackages`; pass the raw one. */
+    config?: Record<string, unknown> | null;
+    /** Absolute path of the mj.config.cjs the config came from — the primary resolution anchor. */
+    configFilePath?: string;
+    /** Which tier to load. Defaults to `'server'`. */
+    tier?: DynamicPackageTier;
+    /**
+     * Also load the host's generated packages named under `codeGeneration.packages`
+     * (entities / actions / graphqlResolvers for the server tier). Defaults to `true`.
+     */
+    includeGeneratedPackages?: boolean;
+    /**
+     * Also discover packages from an Open App manifest (`mj-app.json`) found in
+     * {@link appManifestDir} — the "running inside the app's own repo" case, where the app's
+     * packages are workspace members but nothing has installed them into a host config.
+     * Defaults to `true`.
+     */
+    discoverAppManifest?: boolean;
+    /** Directory holding `mj-app.json`. Defaults to the config file's directory, else `process.cwd()`. */
+    appManifestDir?: string;
+    /** Programmatic mode override (below the env var, above config policy). */
+    mode?: DynamicPackagesMode;
+    /** Output channel. Defaults to `console`. */
+    log?: DynamicPackagesLogger;
+}
+export interface DynamicPackagesReport {
+    ProcessId: string;
+    Tier: DynamicPackageTier;
+    Mode: DynamicPackagesMode;
+    ModeSource: DynamicPackagesModeSource;
+    Loaded: LoadedDynamicPackage[];
+    Skipped: SkippedDynamicPackage[];
+    /** Package names no anchor could resolve — expected before `npm install` or an unbuilt workspace member. */
+    NotFound: DiscoveredDynamicPackage[];
+    Failed: FailedDynamicPackage[];
+}
+//# 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;;;;;;;;;;;GAWG;AAEH,gGAAgG;AAChG,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAChD;AAED,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvE,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC1B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,oBAAoB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IAClE,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjG,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACnE,MAAM,EAAE,wBAAwB,CAAC;CACpC;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IAClE,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IAClC,oCAAoC;IACpC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uFAAuF;IACvF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,6EAA6E;IAC7E,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sGAAsG;IACtG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,6CAA6C;IAC7C,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EAAE,yBAAyB,CAAC;IACtC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,4GAA4G;IAC5G,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAClC"}

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Types for the process-agnostic dynamic package loader.
+ *
+ * A "dynamic package" is an npm package whose name is only known at runtime — it is named by
+ * configuration (`mj.config.cjs` `dynamicPackages.*[]`, written by `mj app install`; the
+ * host's `codeGeneration.packages`), or by an Open App's own `mj-app.json` when a process runs
+ * inside that app's repository. Importing one triggers its `@RegisterClass` decorators so the
+ * ClassFactory returns the app's entity/action/provider subclasses instead of base-class
+ * fallbacks. MJAPI has always done this at boot; every other MJ process (the CLI, MCP/A2A
+ * servers, test bootstraps, ad-hoc scripts) needs the same thing, which is why the loader lives
+ * in a package with no MJ runtime dependencies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,10 +1,39 @@
 {
   "name": "@memberjunction/dynamic-packages",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @memberjunction/dynamic-packages",
+  "version": "6.1.0-edge.6",
+  "description": "MemberJunction: process-agnostic loader for runtime-configured packages (Open App server/client packages, generated entity packages) with per-process scoping",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "/dist"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "memberjunction",
+    "open-app",
+    "dynamic-packages",
+    "bootstrap"
+  ],
+  "author": "MemberJunction.com",
+  "license": "BUSL-1.1",
+  "dependencies": {
+    "cosmiconfig": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.11",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.1",
+    "vite-tsconfig-paths": "^5.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}