@unbrained/pm-cli 2026.6.24 → 2026.6.30

package/dist/sdk/compose.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="376f0804-a437-515f-a653-485531d98f13")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fa377459-0629-5c62-a22b-a21485250792")}catch(e){}}();
 import { normalizeKnownExtensionCapability, resolveLegacyExtensionCapabilityAlias, } from "../core/extensions/extension-capability-aliases.js";
 import { normalizeCommandName } from "../core/extensions/extension-runtime-helpers.js";
 import { evaluatePmMaxVersionBound, evaluatePmMinVersionBound, } from "../core/extensions/version-compat.js";
@@ -41,8 +41,8 @@ export function defineExtensionBlueprint(blueprint) {
  * The returned module's `activate` registers every populated surface through the
  * matching `api.register*` method in a deterministic order (commands → overrides
  * → flags → parsers → renderers → services → preflights → item types → item
- * fields → migrations → search providers → vector store adapters → importers →
- * exporters → hooks), then awaits the blueprint's optional imperative `activate`
+ * fields → migrations → profiles → search providers → vector store adapters →
+ * importers → exporters → hooks), then awaits the blueprint's optional imperative `activate`
  * so it can layer on anything the declarative form cannot express. `manifest`
  * and `deactivate` are copied onto the module verbatim.
  *
@@ -85,6 +85,9 @@ export function composeExtension(blueprint) {
         for (const migration of blueprint.migrations ?? []) {
             api.registerMigration(migration);
         }
+        for (const profile of blueprint.profiles ?? []) {
+            api.registerProfile(profile);
+        }
         for (const provider of blueprint.searchProviders ?? []) {
             api.registerSearchProvider(provider);
         }
@@ -210,8 +213,8 @@ function mergeHookSurfaces(surfaces) {
  * combines the way its underlying `api.register*` call composes:
  *
  * - **Array surfaces** — `commands`, `preflights`, `itemTypes`, `itemFields`,
- *   `migrations`, `searchProviders`, `vectorStoreAdapters`, `importers`,
- *   `exporters` — concatenate in argument order.
+ *   `migrations`, `profiles`, `searchProviders`, `vectorStoreAdapters`,
+ *   `importers`, `exporters` — concatenate in argument order.
  * - **`flags`** concatenates the flag arrays of any shared target command,
  *   mirroring additive `api.registerFlags`: every module's flags reach the command.
  * - **Single-handler records** — `commandOverrides`, `parsers`, `renderers`,
@@ -252,6 +255,7 @@ export function mergeExtensionBlueprints(...blueprints) {
     assign("itemTypes", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemTypes)));
     assign("itemFields", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemFields)));
     assign("migrations", mergeArraySurface(blueprints.map((blueprint) => blueprint.migrations)));
+    assign("profiles", mergeArraySurface(blueprints.map((blueprint) => blueprint.profiles)));
     assign("searchProviders", mergeArraySurface(blueprints.map((blueprint) => blueprint.searchProviders)));
     assign("vectorStoreAdapters", mergeArraySurface(blueprints.map((blueprint) => blueprint.vectorStoreAdapters)));
     assign("importers", mergeArraySurface(blueprints.map((blueprint) => blueprint.importers)));
@@ -322,6 +326,7 @@ const BLUEPRINT_FIELD_CAPABILITIES = [
     ["itemTypes", "schema"],
     ["itemFields", "schema"],
     ["migrations", "schema"],
+    ["profiles", "schema"],
     ["parsers", "parser"],
     ["renderers", "renderers"],
     ["services", "services"],
@@ -366,9 +371,29 @@ export function deriveExtensionCapabilities(blueprint) {
     // what activation enforces when a command declares flags inline and the
     // blueprint has no separate `flags` field. `!== undefined` (not a truthiness or
     // length check) matches the loader's exact guard, including an empty inline array.
-    if ((blueprint.commands ?? []).some((command) => command.flags !== undefined)) {
+    if ((blueprint.commands ?? []).filter(isPresent).some((command) => command.flags !== undefined)) {
+        capabilities.add("schema");
+    }
+    // `registerImporter`/`registerExporter` with `options.flags` register flag
+    // metadata through the same surface as `registerFlags`, asserting the `schema`
+    // capability on top of `importers` (loader `applyImportExportCommandMetadata`).
+    // Mirror that guard so a flag-bearing importer/exporter derives `schema` too —
+    // otherwise a least-privilege manifest synthesized from the blueprint would
+    // under-grant `schema` and fail activation. `!== undefined` matches the loader's
+    // exact `options.flags` guard, including an empty flag array. `entry?.` keeps a
+    // malformed null array entry (from an untyped `.js`/JSON boundary) from crashing
+    // derivation, consistent with the null-field robustness above.
+    const importExportEntries = [...(blueprint.importers ?? []), ...(blueprint.exporters ?? [])].filter(isPresent);
+    if (importExportEntries.some((entry) => entry?.options?.flags !== undefined)) {
         capabilities.add("schema");
     }
+    // Importers/exporters always synthesize command handlers (`<name> import` /
+    // `<name> export`), so runtime capability summaries attribute them to the
+    // commands surface as well as the importers surface. Keep the author-time
+    // capability preview aligned with describeExtensionActivation.
+    if (importExportEntries.some((entry) => typeof entry === "object")) {
+        capabilities.add("commands");
+    }
     // `?? {}` keeps an explicit `hooks: null` from throwing, mirroring composeExtension.
     const hooks = blueprint.hooks ?? {};
     if ([hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(hasEntries)) {
@@ -394,6 +419,9 @@ const BLUEPRINT_HOOK_FIELD_TO_KIND = [
 function sortUnique(values) {
     return [...new Set(values)].sort((left, right) => left.localeCompare(right));
 }
+function isPresent(value) {
+    return value !== null && value !== undefined;
+}
 /**
  * Compute, without activating, the exact {@link ExtensionActivationSummary} that
  * {@link composeExtension}'s generated `activate` would produce for a blueprint.
@@ -419,16 +447,36 @@ function sortUnique(values) {
  * blueprint that registers everything through that hatch summarizes as empty.
  */
 export function describeExtensionBlueprint(blueprint) {
-    const commandPaths = (blueprint.commands ?? []).map((command) => normalizeCommandName(command.name));
-    const importerPaths = (blueprint.importers ?? []).map((entry) => normalizeCommandName(`${entry.name} import`));
-    const exporterPaths = (blueprint.exporters ?? []).map((entry) => normalizeCommandName(`${entry.name} export`));
+    const commands = (blueprint.commands ?? []).filter(isPresent);
+    const importers = (blueprint.importers ?? []).filter(isPresent);
+    const exporters = (blueprint.exporters ?? []).filter(isPresent);
+    const importerPaths = importers.map((entry) => normalizeCommandName(`${entry.name} import`));
+    const exporterPaths = exporters.map((entry) => normalizeCommandName(`${entry.name} export`));
+    const importerCommandDefinitionPaths = importers
+        .filter((entry) => entry.options !== undefined)
+        .map((entry) => normalizeCommandName(`${entry.name} import`));
+    const exporterCommandDefinitionPaths = exporters
+        .filter((entry) => entry.options !== undefined)
+        .map((entry) => normalizeCommandName(`${entry.name} export`));
+    const commandPaths = [
+        ...commands.map((command) => normalizeCommandName(command.name)),
+        ...importerCommandDefinitionPaths,
+        ...exporterCommandDefinitionPaths,
+    ];
     // A command definition with inline `flags` registers a flag target under its own
-    // path in addition to any top-level `flags` record, so union both sources.
+    // path in addition to any top-level `flags` record. Import/export options with
+    // `flags` register through the same runtime metadata path, so union all sources.
     const flagCommands = [
         ...Object.keys(blueprint.flags ?? {}).map((command) => normalizeCommandName(command)),
-        ...(blueprint.commands ?? [])
+        ...commands
             .filter((command) => command.flags !== undefined)
             .map((command) => normalizeCommandName(command.name)),
+        ...importers
+            .filter((entry) => entry.options?.flags !== undefined)
+            .map((entry) => normalizeCommandName(`${entry.name} import`)),
+        ...exporters
+            .filter((entry) => entry.options?.flags !== undefined)
+            .map((entry) => normalizeCommandName(`${entry.name} export`)),
     ];
     const hooks = blueprint.hooks ?? {};
     return {
@@ -445,8 +493,9 @@ export function describeExtensionBlueprint(blueprint) {
         // id-less migrations register but carry no identifier, so they are omitted —
         // exactly as describeExtensionActivation drops them from its `migrations` list.
         migrations: sortUnique((blueprint.migrations ?? []).flatMap((migration) => (typeof migration.id === "string" ? [migration.id] : []))),
-        importers: sortUnique((blueprint.importers ?? []).map((entry) => normalizeCommandName(entry.name))),
-        exporters: sortUnique((blueprint.exporters ?? []).map((entry) => normalizeCommandName(entry.name))),
+        profiles: sortUnique((blueprint.profiles ?? []).map((profile) => profile.name)),
+        importers: sortUnique(importers.map((entry) => normalizeCommandName(entry.name))),
+        exporters: sortUnique(exporters.map((entry) => normalizeCommandName(entry.name))),
         search_providers: sortUnique((blueprint.searchProviders ?? []).map((provider) => provider.name)),
         vector_store_adapters: sortUnique((blueprint.vectorStoreAdapters ?? []).map((adapter) => adapter.name)),
         parser_overrides: sortUnique(Object.keys(blueprint.parsers ?? {}).map((command) => normalizeCommandName(command))),
@@ -472,6 +521,7 @@ const BLUEPRINT_LINTABLE_SURFACE_FIELDS = [
     "itemTypes",
     "itemFields",
     "migrations",
+    "profiles",
     "searchProviders",
     "vectorStoreAdapters",
     "importers",
@@ -838,4 +888,4 @@ export function preflightExtension(blueprint, options = {}) {
     };
 }
 //# sourceMappingURL=compose.js.map
-//# debugId=376f0804-a437-515f-a653-485531d98f13
+//# debugId=fa377459-0629-5c62-a22b-a21485250792