@synergenius/flow-weaver 0.14.2 → 0.15.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -4
- package/dist/cli/flow-weaver.mjs +416 -12202
- package/dist/deployment/index.d.ts +0 -6
- package/dist/deployment/index.js +0 -7
- package/dist/generated-version.d.ts +1 -1
- package/dist/generated-version.js +1 -1
- package/docs/reference/cli-reference.md +2 -2
- package/docs/reference/deployment.md +42 -2
- package/docs/reference/marketplace.md +22 -0
- package/package.json +1 -2
- package/dist/deployment/targets/cloudflare.d.ts +0 -29
- package/dist/deployment/targets/cloudflare.js +0 -1128
- package/dist/deployment/targets/github-actions.d.ts +0 -54
- package/dist/deployment/targets/github-actions.js +0 -366
- package/dist/deployment/targets/gitlab-ci.d.ts +0 -65
- package/dist/deployment/targets/gitlab-ci.js +0 -374
- package/dist/deployment/targets/inngest.d.ts +0 -63
- package/dist/deployment/targets/inngest.js +0 -935
- package/dist/deployment/targets/lambda.d.ts +0 -40
- package/dist/deployment/targets/lambda.js +0 -1294
- package/dist/deployment/targets/vercel.d.ts +0 -39
- package/dist/deployment/targets/vercel.js +0 -891
|
@@ -17,12 +17,6 @@ export { SchemaConverter, schemaConverter, type OpenAPISchema, } from './openapi
|
|
|
17
17
|
export { type ExportTarget, type ExportOptions, type ExportArtifacts, type GeneratedFile, type DeployInstructions, type DeploySchema, type DeploySchemaField, type CompiledWorkflow, type MultiWorkflowArtifacts, type NodeTypeInfo, type NodeTypeExportOptions, type NodeTypeArtifacts, type BundleWorkflow, type BundleNodeType, type BundleArtifacts, BaseExportTarget, ExportTargetRegistry, } from './targets/base.js';
|
|
18
18
|
export { isCICDWorkflow } from '../validation/cicd-detection.js';
|
|
19
19
|
export { generateStandaloneRuntimeModule } from '../api/inline-runtime.js';
|
|
20
|
-
export { LambdaTarget } from './targets/lambda.js';
|
|
21
|
-
export { VercelTarget } from './targets/vercel.js';
|
|
22
|
-
export { CloudflareTarget } from './targets/cloudflare.js';
|
|
23
|
-
export { InngestTarget } from './targets/inngest.js';
|
|
24
|
-
export { GitHubActionsTarget } from './targets/github-actions.js';
|
|
25
|
-
export { GitLabCITarget } from './targets/gitlab-ci.js';
|
|
26
20
|
export { BaseCICDTarget, NODE_ACTION_MAP, type CICDStep, type CICDJob, type ActionMapping, } from './targets/cicd-base.js';
|
|
27
21
|
import { ExportTargetRegistry } from './targets/base.js';
|
|
28
22
|
/**
|
package/dist/deployment/index.js
CHANGED
|
@@ -21,13 +21,6 @@ export { BaseExportTarget, ExportTargetRegistry, } from './targets/base.js';
|
|
|
21
21
|
// Utilities needed by export target packs
|
|
22
22
|
export { isCICDWorkflow } from '../validation/cicd-detection.js';
|
|
23
23
|
export { generateStandaloneRuntimeModule } from '../api/inline-runtime.js';
|
|
24
|
-
// Target implementations — still exported for direct use by pack authors and tests
|
|
25
|
-
export { LambdaTarget } from './targets/lambda.js';
|
|
26
|
-
export { VercelTarget } from './targets/vercel.js';
|
|
27
|
-
export { CloudflareTarget } from './targets/cloudflare.js';
|
|
28
|
-
export { InngestTarget } from './targets/inngest.js';
|
|
29
|
-
export { GitHubActionsTarget } from './targets/github-actions.js';
|
|
30
|
-
export { GitLabCITarget } from './targets/gitlab-ci.js';
|
|
31
24
|
export { BaseCICDTarget, NODE_ACTION_MAP, } from './targets/cicd-base.js';
|
|
32
25
|
import * as path from 'path';
|
|
33
26
|
import { ExportTargetRegistry } from './targets/base.js';
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.15.1";
|
|
2
2
|
//# sourceMappingURL=generated-version.d.ts.map
|
|
@@ -560,7 +560,7 @@ flow-weaver export <input> [options]
|
|
|
560
560
|
|
|
561
561
|
| Flag | Description | Default |
|
|
562
562
|
|------|-------------|---------|
|
|
563
|
-
| `-t, --target <target>` | `lambda`, `vercel`, `cloudflare`, `inngest` **(required)** | — |
|
|
563
|
+
| `-t, --target <target>` | Target from installed packs (e.g. `lambda`, `vercel`, `cloudflare`, `inngest`, `github-actions`, `gitlab-ci`) **(required)** | — |
|
|
564
564
|
| `-o, --output <path>` | Output directory **(required)** | — |
|
|
565
565
|
| `-w, --workflow <name>` | Specific workflow | — |
|
|
566
566
|
| `-p, --production` | Production mode | `true` |
|
|
@@ -578,7 +578,7 @@ flow-weaver export workflow.ts --target inngest --output dist/ --durable-steps
|
|
|
578
578
|
flow-weaver export workflow.ts --target cloudflare --output worker/
|
|
579
579
|
```
|
|
580
580
|
|
|
581
|
-
> See
|
|
581
|
+
> Available targets depend on installed `flowweaver-pack-*` packages. See [Deployment](deployment) for installation instructions and target-specific details.
|
|
582
582
|
|
|
583
583
|
---
|
|
584
584
|
|
|
@@ -1,12 +1,32 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: Deployment
|
|
3
3
|
description: Export workflows to serverless platforms, HTTP serve mode, OpenAPI generation, and multi-workflow services
|
|
4
|
-
keywords: [deploy, export, lambda, vercel, cloudflare, inngest, serve, openapi, swagger, serverless, multi-workflow, durable-steps, webhook, http, cors]
|
|
4
|
+
keywords: [deploy, export, lambda, vercel, cloudflare, inngest, github-actions, gitlab-ci, serve, openapi, swagger, serverless, multi-workflow, durable-steps, webhook, http, cors, packs, marketplace]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Deployment
|
|
8
8
|
|
|
9
|
-
Flow Weaver workflows can be deployed as serverless functions, HTTP endpoints,
|
|
9
|
+
Flow Weaver workflows can be deployed as serverless functions, HTTP endpoints, durable event-driven functions, or CI/CD pipelines. This guide covers all deployment options.
|
|
10
|
+
|
|
11
|
+
## Installing Export Target Packs
|
|
12
|
+
|
|
13
|
+
Export targets are provided by marketplace packs. Install the ones you need:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# Serverless targets
|
|
17
|
+
npm install @synergenius/flowweaver-pack-lambda
|
|
18
|
+
npm install @synergenius/flowweaver-pack-vercel
|
|
19
|
+
npm install @synergenius/flowweaver-pack-cloudflare
|
|
20
|
+
npm install @synergenius/flowweaver-pack-inngest
|
|
21
|
+
|
|
22
|
+
# CI/CD targets
|
|
23
|
+
npm install @synergenius/flowweaver-pack-github-actions
|
|
24
|
+
npm install @synergenius/flowweaver-pack-gitlab-ci
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
The `export` command automatically discovers installed packs — no configuration needed.
|
|
28
|
+
|
|
29
|
+
---
|
|
10
30
|
|
|
11
31
|
## Export Targets
|
|
12
32
|
|
|
@@ -63,6 +83,26 @@ Add `--durable-steps` for per-node `step.run()` durability:
|
|
|
63
83
|
flow-weaver export workflow.ts --target inngest --output dist/ --durable-steps
|
|
64
84
|
```
|
|
65
85
|
|
|
86
|
+
### GitHub Actions
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
flow-weaver export workflow.ts --target github-actions --output .github/workflows/
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Generates:
|
|
93
|
+
- GitHub Actions workflow YAML with jobs mapped from workflow nodes
|
|
94
|
+
- Proper step ordering and dependency configuration
|
|
95
|
+
|
|
96
|
+
### GitLab CI
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
flow-weaver export workflow.ts --target gitlab-ci --output .
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Generates:
|
|
103
|
+
- `.gitlab-ci.yml` with stages and jobs mapped from workflow nodes
|
|
104
|
+
- Pipeline configuration with proper stage ordering
|
|
105
|
+
|
|
66
106
|
---
|
|
67
107
|
|
|
68
108
|
## Multi-Workflow Export
|
|
@@ -15,9 +15,31 @@ The Flow Weaver marketplace is an npm-based ecosystem for sharing reusable node
|
|
|
15
15
|
| **Node types** | Reusable `@flowWeaver nodeType` functions |
|
|
16
16
|
| **Workflows** | Complete `@flowWeaver workflow` exports |
|
|
17
17
|
| **Patterns** | Reusable `@flowWeaver pattern` fragments |
|
|
18
|
+
| **Export targets** | Deployment targets for `flow-weaver export` |
|
|
18
19
|
|
|
19
20
|
A single package can contain any combination of these.
|
|
20
21
|
|
|
22
|
+
## Official Export Target Packs
|
|
23
|
+
|
|
24
|
+
Flow Weaver provides 6 official export target packs:
|
|
25
|
+
|
|
26
|
+
| Package | Target name | Description |
|
|
27
|
+
|---------|-------------|-------------|
|
|
28
|
+
| `@synergenius/flowweaver-pack-lambda` | `lambda` | AWS Lambda + API Gateway |
|
|
29
|
+
| `@synergenius/flowweaver-pack-vercel` | `vercel` | Vercel serverless functions |
|
|
30
|
+
| `@synergenius/flowweaver-pack-cloudflare` | `cloudflare` | Cloudflare Workers |
|
|
31
|
+
| `@synergenius/flowweaver-pack-inngest` | `inngest` | Inngest durable functions |
|
|
32
|
+
| `@synergenius/flowweaver-pack-github-actions` | `github-actions` | GitHub Actions CI/CD pipelines |
|
|
33
|
+
| `@synergenius/flowweaver-pack-gitlab-ci` | `gitlab-ci` | GitLab CI/CD pipelines |
|
|
34
|
+
|
|
35
|
+
Install with:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npm install @synergenius/flowweaver-pack-lambda
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
See [Deployment](deployment) for target-specific usage details.
|
|
42
|
+
|
|
21
43
|
---
|
|
22
44
|
|
|
23
45
|
## Using Packages
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@synergenius/flow-weaver",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.15.1",
|
|
4
4
|
"description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
@@ -142,7 +142,6 @@
|
|
|
142
142
|
"source-map": "^0.7.6",
|
|
143
143
|
"ts-morph": "^21.0.1",
|
|
144
144
|
"ws": "^8.19.0",
|
|
145
|
-
"yaml": "^2.8.2",
|
|
146
145
|
"zod": "^3.22.4"
|
|
147
146
|
},
|
|
148
147
|
"devDependencies": {
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Cloudflare Workers export target
|
|
3
|
-
*
|
|
4
|
-
* Generates Cloudflare Workers with Wrangler configuration.
|
|
5
|
-
*/
|
|
6
|
-
import { BaseExportTarget, type ExportOptions, type ExportArtifacts, type DeployInstructions, type CompiledWorkflow, type MultiWorkflowArtifacts, type NodeTypeInfo, type NodeTypeExportOptions, type NodeTypeArtifacts, type BundleWorkflow, type BundleNodeType, type BundleArtifacts } from './base.js';
|
|
7
|
-
/**
|
|
8
|
-
* Cloudflare Workers export target
|
|
9
|
-
*/
|
|
10
|
-
export declare class CloudflareTarget extends BaseExportTarget {
|
|
11
|
-
readonly name = "cloudflare";
|
|
12
|
-
readonly description = "Cloudflare Workers";
|
|
13
|
-
readonly deploySchema: {
|
|
14
|
-
compatDate: {
|
|
15
|
-
type: "string";
|
|
16
|
-
description: string;
|
|
17
|
-
};
|
|
18
|
-
};
|
|
19
|
-
generate(options: ExportOptions): Promise<ExportArtifacts>;
|
|
20
|
-
/**
|
|
21
|
-
* Generate OpenAPI specification for the workflow
|
|
22
|
-
*/
|
|
23
|
-
private generateOpenAPISpec;
|
|
24
|
-
generateMultiWorkflow(workflows: CompiledWorkflow[], options: ExportOptions): Promise<MultiWorkflowArtifacts>;
|
|
25
|
-
generateNodeTypeService(nodeTypes: NodeTypeInfo[], options: NodeTypeExportOptions): Promise<NodeTypeArtifacts>;
|
|
26
|
-
generateBundle(workflows: BundleWorkflow[], nodeTypes: BundleNodeType[], options: ExportOptions): Promise<BundleArtifacts>;
|
|
27
|
-
getDeployInstructions(artifacts: ExportArtifacts): DeployInstructions;
|
|
28
|
-
}
|
|
29
|
-
//# sourceMappingURL=cloudflare.d.ts.map
|