@synergenius/flow-weaver 0.21.5 → 0.21.7
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 +3 -3
- package/dist/cli/flow-weaver.mjs +671 -192
- package/dist/cli/pack-commands.js +1 -1
- package/dist/diagram/geometry.d.ts +2 -0
- package/dist/diagram/geometry.js +36 -4
- package/dist/diagram/html-viewer.js +270 -38
- package/dist/diagram/renderer.js +29 -5
- package/dist/diagram/types.d.ts +10 -0
- package/dist/generated-version.d.ts +1 -1
- package/dist/generated-version.js +1 -1
- package/dist/marketplace/registry.js +2 -4
- package/dist/marketplace/validator.js +1 -1
- package/docs/reference/cli-reference.md +1 -1
- package/docs/reference/deployment.md +6 -6
- package/docs/reference/marketplace.md +18 -18
- package/package.json +1 -1
|
@@ -14,14 +14,14 @@ Export targets are provided by marketplace packs. Install the ones you need:
|
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
# Serverless targets
|
|
17
|
-
npm install @synergenius/
|
|
18
|
-
npm install @synergenius/
|
|
19
|
-
npm install @synergenius/
|
|
20
|
-
npm install @synergenius/
|
|
17
|
+
npm install @synergenius/flow-weaver-pack-lambda
|
|
18
|
+
npm install @synergenius/flow-weaver-pack-vercel
|
|
19
|
+
npm install @synergenius/flow-weaver-pack-cloudflare
|
|
20
|
+
npm install @synergenius/flow-weaver-pack-inngest
|
|
21
21
|
|
|
22
22
|
# CI/CD targets
|
|
23
|
-
npm install @synergenius/
|
|
24
|
-
npm install @synergenius/
|
|
23
|
+
npm install @synergenius/flow-weaver-pack-github-actions
|
|
24
|
+
npm install @synergenius/flow-weaver-pack-gitlab-ci
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
The `export` command automatically discovers installed packs — no configuration needed.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: Marketplace
|
|
3
3
|
description: Create, publish, install, and manage Flow Weaver marketplace packages and external plugins
|
|
4
|
-
keywords: [marketplace, market, package, publish, install, search, npm,
|
|
4
|
+
keywords: [marketplace, market, package, publish, install, search, npm, flow-weaver-pack, plugin, init, manifest, node types, patterns, workflows, component, area, sandbox]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Marketplace
|
|
8
8
|
|
|
9
|
-
The Flow Weaver marketplace is an npm-based ecosystem for sharing reusable node types, workflows, and patterns. Packages follow the `
|
|
9
|
+
The Flow Weaver marketplace is an npm-based ecosystem for sharing reusable node types, workflows, and patterns. Packages follow the `flow-weaver-pack-*` naming convention and are discoverable via npm search.
|
|
10
10
|
|
|
11
11
|
## Overview
|
|
12
12
|
|
|
@@ -25,17 +25,17 @@ Flow Weaver provides 6 official export target packs:
|
|
|
25
25
|
|
|
26
26
|
| Package | Target name | Description |
|
|
27
27
|
|---------|-------------|-------------|
|
|
28
|
-
| `@synergenius/
|
|
29
|
-
| `@synergenius/
|
|
30
|
-
| `@synergenius/
|
|
31
|
-
| `@synergenius/
|
|
32
|
-
| `@synergenius/
|
|
33
|
-
| `@synergenius/
|
|
28
|
+
| `@synergenius/flow-weaver-pack-lambda` | `lambda` | AWS Lambda + API Gateway |
|
|
29
|
+
| `@synergenius/flow-weaver-pack-vercel` | `vercel` | Vercel serverless functions |
|
|
30
|
+
| `@synergenius/flow-weaver-pack-cloudflare` | `cloudflare` | Cloudflare Workers |
|
|
31
|
+
| `@synergenius/flow-weaver-pack-inngest` | `inngest` | Inngest durable functions |
|
|
32
|
+
| `@synergenius/flow-weaver-pack-github-actions` | `github-actions` | GitHub Actions CI/CD pipelines |
|
|
33
|
+
| `@synergenius/flow-weaver-pack-gitlab-ci` | `gitlab-ci` | GitLab CI/CD pipelines |
|
|
34
34
|
|
|
35
35
|
Install with:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
npm install @synergenius/
|
|
38
|
+
npm install @synergenius/flow-weaver-pack-lambda
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
See [Deployment](deployment) for target-specific usage details.
|
|
@@ -65,8 +65,8 @@ flow-weaver market search openai --registry https://npm.internal.com
|
|
|
65
65
|
Install a package:
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
|
-
flow-weaver market install
|
|
69
|
-
flow-weaver market install
|
|
68
|
+
flow-weaver market install flow-weaver-pack-openai
|
|
69
|
+
flow-weaver market install flow-weaver-pack-openai@1.0.0
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
After installation, the package's node types, workflows, and patterns are available for use in your workflows via `@fwImport`.
|
|
@@ -77,7 +77,7 @@ After installation, the package's node types, workflows, and patterns are availa
|
|
|
77
77
|
flow-weaver market list
|
|
78
78
|
```
|
|
79
79
|
|
|
80
|
-
Shows all installed `
|
|
80
|
+
Shows all installed `flow-weaver-pack-*` packages with their available node types, workflows, and patterns.
|
|
81
81
|
|
|
82
82
|
---
|
|
83
83
|
|
|
@@ -91,8 +91,8 @@ Create a new marketplace package:
|
|
|
91
91
|
flow-weaver market init openai
|
|
92
92
|
```
|
|
93
93
|
|
|
94
|
-
This creates a `
|
|
95
|
-
- `package.json` — Configured with `flowweaver-pack` keyword
|
|
94
|
+
This creates a `flow-weaver-pack-openai/` directory with:
|
|
95
|
+
- `package.json` — Configured with `flowweaver-marketplace-pack` keyword
|
|
96
96
|
- `src/` — Source directory for node types, workflows, and patterns
|
|
97
97
|
- `tsconfig.json` — TypeScript configuration
|
|
98
98
|
|
|
@@ -106,7 +106,7 @@ flow-weaver market init openai -y # Skip prompts
|
|
|
106
106
|
### Package Structure
|
|
107
107
|
|
|
108
108
|
```
|
|
109
|
-
|
|
109
|
+
flow-weaver-pack-openai/
|
|
110
110
|
src/
|
|
111
111
|
nodes/
|
|
112
112
|
chat-completion.ts # @flowWeaver nodeType functions
|
|
@@ -149,8 +149,8 @@ flow-weaver market publish --tag beta # Publish with dist-tag
|
|
|
149
149
|
|
|
150
150
|
The `market pack` command validates packages against additional rules beyond standard workflow validation:
|
|
151
151
|
|
|
152
|
-
- Package name must start with `
|
|
153
|
-
- Must include `flowweaver-pack` keyword in `package.json`
|
|
152
|
+
- Package name must start with `flow-weaver-pack-`
|
|
153
|
+
- Must include `flowweaver-marketplace-pack` keyword in `package.json`
|
|
154
154
|
- All exported node types must have proper annotations
|
|
155
155
|
- All exported workflows must validate successfully
|
|
156
156
|
- No conflicting node type names
|
|
@@ -163,7 +163,7 @@ The `market pack` command validates packages against additional rules beyond sta
|
|
|
163
163
|
|
|
164
164
|
Tag handlers let packs extend the parser with custom JSDoc annotations. When the parser encounters a tag it doesn't recognize natively, it delegates to registered pack handlers before emitting "Unknown annotation" warnings.
|
|
165
165
|
|
|
166
|
-
The CI/CD pack (`
|
|
166
|
+
The CI/CD pack (`flow-weaver-pack-cicd`) is the primary example: it registers handlers for `@secret`, `@runner`, `@cache`, `@artifact`, and other CI/CD tags.
|
|
167
167
|
|
|
168
168
|
### Writing a handler
|
|
169
169
|
|
package/package.json
CHANGED