@usearazzo/runner 1.0.1-alpha.24 → 1.0.1-alpha.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usearazzo/runner",
-  "version": "1.0.1-alpha.24",
+  "version": "1.0.1-alpha.26",
   "description": "Runner for Arazzo Workflows.",
   "keywords": [
     "arazzo",
@@ -73,8 +73,8 @@
     "@swaggerexpert/json-pointer": "^3.0.2",
     "@swaggerexpert/jsonpath": "^4.0.5",
     "@swaggerexpert/media-types": "^1.0.2",
-    "@usearazzo/parser": "1.0.1-alpha.24",
-    "@usearazzo/resolver": "1.0.1-alpha.24",
+    "@usearazzo/parser": "1.0.1-alpha.26",
+    "@usearazzo/resolver": "1.0.1-alpha.26",
     "@xmldom/xmldom": "^0.9.12",
     "fontoxpath": "^3.34.0",
     "ramda": "^0.32.0",
@@ -94,5 +94,5 @@
   "devDependencies": {
     "swagger-client": "^3.38.4"
   },
-  "gitHead": "ba457d4dfc1a0a0ccd91e38ad9b33b08d07dc3f0"
+  "gitHead": "8bacf6bf0e5d1e4c44a81583c5f1719bbbefaf97"
 }

package/src/document/ArazzoDocument.cjs

@@ -6,11 +6,19 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomJsonPointer = require("@speclynx/apidom-json-pointer");
 var _APIDocument = _interopRequireDefault(require("./APIDocument.cjs"));
+/**
+ * A workflow of an Arazzo document, as listed by
+ * {@link ArazzoDocument.listWorkflows}.
+ * @public
+ */
+
 /**
  * An Arazzo document held by the document registry: the parse result together
  * with the indexes the provider built over it — a container, not a logic
- * bearer. The methods below are thin reads of the source description index.
+ * bearer. The methods below are thin reads of those indexes.
  * @public
  */
 class ArazzoDocument extends _APIDocument.default {
@@ -46,6 +54,31 @@ class ArazzoDocument extends _APIDocument.default {
     return doc.type === 'arazzo';
   }
 
+  /**
+   * The workflows of this document that can be addressed by `workflowId`, in
+   * document order. A duplicated `workflowId` is listed once, for its first
+   * workflow. Reads this document only: source descriptions are neither loaded
+   * nor listed.
+   */
+  listWorkflows() {
+    return [...this.workflowIndex].map(([workflowId, jsonPointer]) => {
+      const {
+        summary,
+        description
+      } = (0, _apidomJsonPointer.evaluate)(this.parseResult.api, jsonPointer);
+      return {
+        workflowId,
+        jsonPointer,
+        ...((0, _apidomDatamodel.isStringElement)(summary) && {
+          summary: (0, _apidomCore.toValue)(summary)
+        }),
+        ...((0, _apidomDatamodel.isStringElement)(description) && {
+          description: (0, _apidomCore.toValue)(description)
+        })
+      };
+    });
+  }
+
   /**
    * Resolves a source description name to its canonical URI — precomputed by
    * the provider, resolved against this document's base URI.

package/src/document/ArazzoDocument.mjs

@@ -1,9 +1,16 @@
 import { toValue } from '@speclynx/apidom-core';
+import { isStringElement } from '@speclynx/apidom-datamodel';
+import { evaluate } from '@speclynx/apidom-json-pointer';
 import APIDocument from "./APIDocument.mjs";
+/**
+ * A workflow of an Arazzo document, as listed by
+ * {@link ArazzoDocument.listWorkflows}.
+ * @public
+ */
 /**
  * An Arazzo document held by the document registry: the parse result together
  * with the indexes the provider built over it — a container, not a logic
- * bearer. The methods below are thin reads of the source description index.
+ * bearer. The methods below are thin reads of those indexes.
  * @public
  */
 class ArazzoDocument extends APIDocument {
@@ -39,6 +46,31 @@ class ArazzoDocument extends APIDocument {
     return doc.type === 'arazzo';
   }
 
+  /**
+   * The workflows of this document that can be addressed by `workflowId`, in
+   * document order. A duplicated `workflowId` is listed once, for its first
+   * workflow. Reads this document only: source descriptions are neither loaded
+   * nor listed.
+   */
+  listWorkflows() {
+    return [...this.workflowIndex].map(([workflowId, jsonPointer]) => {
+      const {
+        summary,
+        description
+      } = evaluate(this.parseResult.api, jsonPointer);
+      return {
+        workflowId,
+        jsonPointer,
+        ...(isStringElement(summary) && {
+          summary: toValue(summary)
+        }),
+        ...(isStringElement(description) && {
+          description: toValue(description)
+        })
+      };
+    });
+  }
+
   /**
    * Resolves a source description name to its canonical URI — precomputed by
    * the provider, resolved against this document's base URI.

package/src/registry/providers/ArazzoDocumentRegistryProvider.cjs

@@ -99,7 +99,8 @@ class ArazzoDocumentRegistryProvider extends _DocumentRegistryProvider.default {
    * A source description's canonical URI is resolved here too — against the
    * document's base URI, into the exact form the document registry keys on —
    * so every consumer works with a ready-to-use, non-relative URI. The first
-   * element of a duplicated source description name wins.
+   * element of a duplicated source description name wins, and so does the
+   * first workflow of a duplicated workflowId.
    */
   #buildIndexes(uri, parseResult) {
     const workflowIndex = new _ArazzoWorkflowIndex.default();
@@ -111,6 +112,7 @@ class ArazzoDocumentRegistryProvider extends _DocumentRegistryProvider.default {
         const workflowId = (0, _apidomCore.toValue)(workflow.workflowId);
         if (typeof workflowId !== 'string') return path.skip();
         if (workflowId === '') return path.skip();
+        if (workflowIndex.has(workflowId)) return path.skip();
         const workflowPointer = path.formatPath('jsonpointer');
         workflowIndex.set(workflowId, workflowPointer);
 

package/src/registry/providers/ArazzoDocumentRegistryProvider.mjs

@@ -91,7 +91,8 @@ class ArazzoDocumentRegistryProvider extends DocumentRegistryProvider {
    * A source description's canonical URI is resolved here too — against the
    * document's base URI, into the exact form the document registry keys on —
    * so every consumer works with a ready-to-use, non-relative URI. The first
-   * element of a duplicated source description name wins.
+   * element of a duplicated source description name wins, and so does the
+   * first workflow of a duplicated workflowId.
    */
   #buildIndexes(uri, parseResult) {
     const workflowIndex = new ArazzoWorkflowIndex();
@@ -103,6 +104,7 @@ class ArazzoDocumentRegistryProvider extends DocumentRegistryProvider {
         const workflowId = toValue(workflow.workflowId);
         if (typeof workflowId !== 'string') return path.skip();
         if (workflowId === '') return path.skip();
+        if (workflowIndex.has(workflowId)) return path.skip();
         const workflowPointer = path.formatPath('jsonpointer');
         workflowIndex.set(workflowId, workflowPointer);
 

package/src/registry/providers/OpenAPIDocumentRegistryProvider.cjs

@@ -44,6 +44,7 @@ const providerOptionsOverride = exports.providerOptionsOverride = {
  * Provides OpenAPIDocument instances for the DocumentRegistry.
  *
  * Parses, dereferences, and builds an OperationIndex for OpenAPI documents.
+ * The first operation of a duplicated operationId wins.
  * @public
  */
 class OpenAPIDocumentRegistryProvider extends _DocumentRegistryProvider.default {
@@ -95,6 +96,7 @@ class OpenAPIDocumentRegistryProvider extends _DocumentRegistryProvider.default
         const operationId = (0, _apidomCore.toValue)(operation.operationId);
         if (typeof operationId !== 'string') return path.skip();
         if (operationId === '') return path.skip();
+        if (index.has(operationId)) return path.skip();
         index.set(operationId, path.formatPath('jsonpointer'));
         path.skip();
       }

package/src/registry/providers/OpenAPIDocumentRegistryProvider.mjs

@@ -36,6 +36,7 @@ export const providerOptionsOverride = {
  * Provides OpenAPIDocument instances for the DocumentRegistry.
  *
  * Parses, dereferences, and builds an OperationIndex for OpenAPI documents.
+ * The first operation of a duplicated operationId wins.
  * @public
  */
 class OpenAPIDocumentRegistryProvider extends DocumentRegistryProvider {
@@ -87,6 +88,7 @@ class OpenAPIDocumentRegistryProvider extends DocumentRegistryProvider {
         const operationId = toValue(operation.operationId);
         if (typeof operationId !== 'string') return path.skip();
         if (operationId === '') return path.skip();
+        if (index.has(operationId)) return path.skip();
         index.set(operationId, path.formatPath('jsonpointer'));
         path.skip();
       }

package/types/runner.d.ts

@@ -97,7 +97,7 @@ export declare abstract class APIDocument {
 /**
  * An Arazzo document held by the document registry: the parse result together
  * with the indexes the provider built over it — a container, not a logic
- * bearer. The methods below are thin reads of the source description index.
+ * bearer. The methods below are thin reads of those indexes.
  * @public
  */
 export declare class ArazzoDocument extends APIDocument {
@@ -123,6 +123,13 @@ export declare class ArazzoDocument extends APIDocument {
      * Type guard for ArazzoDocument.
      */
     static is(doc: APIDocument): doc is ArazzoDocument;
+    /**
+     * The workflows of this document that can be addressed by `workflowId`, in
+     * document order. A duplicated `workflowId` is listed once, for its first
+     * workflow. Reads this document only: source descriptions are neither loaded
+     * nor listed.
+     */
+    listWorkflows(): WorkflowDescriptor[];
     /**
      * Resolves a source description name to its canonical URI — precomputed by
      * the provider, resolved against this document's base URI.
@@ -1079,6 +1086,7 @@ export declare interface OpenAPIDocumentAssemblerOptions {
  * Provides OpenAPIDocument instances for the DocumentRegistry.
  *
  * Parses, dereferences, and builds an OperationIndex for OpenAPI documents.
+ * The first operation of a duplicated operationId wins.
  * @public
  */
 export declare class OpenAPIDocumentRegistryProvider extends DocumentRegistryProvider {
@@ -2402,6 +2410,31 @@ export declare class UnmatchedProviderError extends ArazzoRunnerError {
     readonly uri?: string;
 }
 
+/**
+ * A workflow of an Arazzo document, as listed by
+ * {@link ArazzoDocument.listWorkflows}.
+ * @public
+ */
+export declare interface WorkflowDescriptor {
+    /**
+     * The id `ArazzoRunner.execute` takes to run the workflow.
+     */
+    workflowId: WorkflowId;
+    /**
+     * JSON Pointer to the workflow within the document.
+     */
+    jsonPointer: JSONPointer;
+    /**
+     * Present only when the workflow has a string `summary`.
+     */
+    summary?: string;
+    /**
+     * Present only when the workflow has a string `description`, as written
+     * (CommonMark).
+     */
+    description?: string;
+}
+
 /**
  * Per-call options for {@link WorkflowExecutor.execute}.
  * @public