@dotbep/core 0.2.16 → 0.2.18

package/dist/index.d.ts

@@ -619,7 +619,10 @@ export declare interface BepTypes {
         eventId: string;
     } & Record<string, unknown>>;
     resolvers: Record<string, (url: string, ...args: any[]) => unknown>;
-    triggers: Record<string, (rawPayload: unknown) => Promise<WorkflowInstance['trackedAsset']>>;
+    triggers: Record<string, (rawPayload: unknown) => Promise<{
+        trackedAsset: WorkflowInstance['trackedAsset'];
+        workflowId: string;
+    }>>;
     env: Record<string, string>;
 }
 
@@ -877,7 +880,6 @@ export declare class Effects extends Entity<FlowEffect> {
 
 export declare class Engine {
     private readonly getBep;
-    private readonly getHistoricalBep?;
     private _runtime;
     private storage;
     private skipRaci;
@@ -890,7 +892,7 @@ export declare class Engine {
     get runtime(): Runtime<any>;
     /** Namespaced workflow instance operations. */
     readonly workflows: {
-        create(workflowId: string, trackedAsset: WorkflowInstance['trackedAsset'] | {
+        create(id: string, trackedAsset: WorkflowInstance['trackedAsset'] | {
             rawPayload: unknown;
         }, initiatedBy: string): Promise<WorkflowInstance | null>;
         emit(instanceId: string, event: IncomingEvent): Promise<EventResult>;
@@ -907,7 +909,7 @@ export declare class Engine {
         onEffectFailed(listener: EffectFailedListener): Engine;
         onAutomationFailed(listener: AutomationFailedListener): Engine;
     };
-    constructor(getBep: () => BEP, getHistoricalBep?: (version: string) => Promise<BEP>);
+    constructor(getBep: () => BEP);
     /**
      * Configures the engine with a runtime and storage backend.
      * Must be called before any operations (workflows.create, workflows.emit, etc.).
@@ -924,7 +926,6 @@ export declare class Engine {
     private _getStatus;
     private _resolveContext;
     private _assertInit;
-    private _resolveBep;
     private _fire;
     private _executeAutomationNode;
     private _executeEffect;
@@ -1648,9 +1649,7 @@ export declare interface InstanceFilter {
     status?: InstanceStatus;
     /** Member.email — returns instances where this actor has a pending RACI action. */
     pendingActionFor?: string;
-    /** ref AssetType.id */
-    trackedAssetTypeId?: string;
-    /** ID of the asset in the external system. */
+    /** ref internal asset id (e.g. Deliverable.id) — only matches source: 'internal' instances. */
     trackedAssetId?: string;
 }
 
@@ -2245,7 +2244,7 @@ export declare class Runtime<T extends {
     protected effect<K extends keyof T['effects'] & string>(key: K, handler: (instance: WorkflowInstance, ...args: Parameters<T['effects'][K]>) => Promise<void>): this;
     protected automation<K extends keyof T['automations'] & string>(key: K, handler: (instance: WorkflowInstance, ...args: Parameters<T['automations'][K]>) => Promise<ReturnType<T['automations'][K]>>): this;
     protected resolver<K extends keyof T['resolvers'] & string>(key: K, handler: (...args: Parameters<T['resolvers'][K]>) => Promise<ReturnType<T['resolvers'][K]>>): this;
-    protected trigger<K extends keyof T['triggers'] & string>(key: K, handler: (rawPayload: unknown) => Promise<WorkflowInstance['trackedAsset']>): this;
+    protected trigger<K extends keyof T['triggers'] & string>(key: K, handler: (...args: Parameters<T['triggers'][K]>) => ReturnType<T['triggers'][K]>): this;
     /* Excluded from this release type: _runResolver */
 }
 
@@ -2462,11 +2461,14 @@ export declare interface TransitionStep {
 }
 
 /**
- * Handler registered for a specific workflow trigger (keyed by Workflow.id).
+ * Handler registered for a specific software trigger (keyed by Software.id).
  * Receives a raw payload from an external system and returns the trackedAsset
- * that the engine will use to create the workflow instance.
+ * plus the workflowId the engine will use to create the workflow instance.
  */
-export declare type TriggerHandler = (rawPayload: unknown) => Promise<WorkflowInstance['trackedAsset']>;
+export declare type TriggerHandler = (rawPayload: unknown) => Promise<{
+    trackedAsset: WorkflowInstance['trackedAsset'];
+    workflowId: string;
+}>;
 
 /**
  * Validates all token-bearing entity IDs in a BEP against a naming convention.
@@ -2496,21 +2498,14 @@ export declare interface WorkflowInstance {
     id: string;
     /** ref Workflow.id */
     workflowId: string;
-    /** BEP version at the time this instance was created — used to load the correct workflow definition. */
-    bepVersion: string;
     /** The asset this instance is tracking. */
     trackedAsset: {
-        /** ref AssetType.id */
-        assetTypeId: string;
-        /**
-         * Namespace that identifies where the asset lives.
-         * Format: "bep:<entityName>" for BEP-internal entities (e.g. "bep:deliverables"),
-         * or "external:<softwareId>" for assets in external systems (e.g. "external:software-acc").
-         * The softwareId must match a Software.id declared in the BEP (which cannot contain colons).
-         */
-        source: string;
-        /** ID of the asset — ref to the entity within the source. */
+        source: 'internal';
+        type: 'deliverable';
         id: string;
+    } | {
+        source: 'external';
+        url: string;
         label: string;
     };
     /** Key of the current FlowNode. Not a decision node — engine auto-traverses those. */