@synergenius/flow-weaver 0.21.5 → 0.21.6
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 +5 -7
- package/dist/cli/pack-commands.js +1 -1
- 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
package/README.md
CHANGED
|
@@ -250,9 +250,9 @@ The scope's output ports become callback parameters, and input ports become retu
|
|
|
250
250
|
Same workflow source, multiple deployment targets. Export targets are provided by marketplace packs — install the ones you need:
|
|
251
251
|
|
|
252
252
|
```bash
|
|
253
|
-
npm install @synergenius/
|
|
254
|
-
@synergenius/
|
|
255
|
-
@synergenius/
|
|
253
|
+
npm install @synergenius/flow-weaver-pack-lambda @synergenius/flow-weaver-pack-vercel \
|
|
254
|
+
@synergenius/flow-weaver-pack-cloudflare @synergenius/flow-weaver-pack-inngest \
|
|
255
|
+
@synergenius/flow-weaver-pack-github-actions @synergenius/flow-weaver-pack-gitlab-ci
|
|
256
256
|
```
|
|
257
257
|
|
|
258
258
|
```bash
|
package/dist/cli/flow-weaver.mjs
CHANGED
|
@@ -9469,7 +9469,7 @@ var VERSION;
|
|
|
9469
9469
|
var init_generated_version = __esm({
|
|
9470
9470
|
"src/generated-version.ts"() {
|
|
9471
9471
|
"use strict";
|
|
9472
|
-
VERSION = "0.21.
|
|
9472
|
+
VERSION = "0.21.6";
|
|
9473
9473
|
}
|
|
9474
9474
|
});
|
|
9475
9475
|
|
|
@@ -35114,8 +35114,6 @@ async function listInstalledPackages(projectDir) {
|
|
|
35114
35114
|
const nodeModules = path5.join(projectDir, "node_modules");
|
|
35115
35115
|
if (!fs5.existsSync(nodeModules)) return [];
|
|
35116
35116
|
const patterns = [
|
|
35117
|
-
path5.join(nodeModules, "flowweaver-pack-*", "flowweaver.manifest.json"),
|
|
35118
|
-
path5.join(nodeModules, "@*", "flowweaver-pack-*", "flowweaver.manifest.json"),
|
|
35119
35117
|
path5.join(nodeModules, "flow-weaver-pack-*", "flowweaver.manifest.json"),
|
|
35120
35118
|
path5.join(nodeModules, "@*", "flow-weaver-pack-*", "flowweaver.manifest.json")
|
|
35121
35119
|
];
|
|
@@ -35224,7 +35222,7 @@ var init_registry = __esm({
|
|
|
35224
35222
|
init_esm5();
|
|
35225
35223
|
MARKETPLACE_KEYWORD = "flowweaver-marketplace-pack";
|
|
35226
35224
|
NPM_SEARCH_URL = "https://registry.npmjs.org/-/v1/search";
|
|
35227
|
-
PACK_NAME_RE = /^(@[^/]+\/)?
|
|
35225
|
+
PACK_NAME_RE = /^(@[^/]+\/)?flow-weaver-pack-.+$/;
|
|
35228
35226
|
}
|
|
35229
35227
|
});
|
|
35230
35228
|
|
|
@@ -69906,7 +69904,7 @@ function checkPackEngineVersion2(pkg) {
|
|
|
69906
69904
|
}
|
|
69907
69905
|
function deriveNamespace(packageName) {
|
|
69908
69906
|
const base = packageName.replace(/^@[^/]+\//, "");
|
|
69909
|
-
return base.replace(/^
|
|
69907
|
+
return base.replace(/^flow-weaver-pack-/, "");
|
|
69910
69908
|
}
|
|
69911
69909
|
async function registerPackCommands(program3) {
|
|
69912
69910
|
const projectDir = process.cwd();
|
|
@@ -88142,7 +88140,7 @@ import * as path32 from "path";
|
|
|
88142
88140
|
function issue2(code, severity, message) {
|
|
88143
88141
|
return { code, severity, message };
|
|
88144
88142
|
}
|
|
88145
|
-
var PACK_NAME_RE2 = /^(@[^/]+\/)?
|
|
88143
|
+
var PACK_NAME_RE2 = /^(@[^/]+\/)?flow-weaver-pack-.+$/;
|
|
88146
88144
|
var MARKETPLACE_KEYWORD2 = "flowweaver-marketplace-pack";
|
|
88147
88145
|
function validatePackageJson(pkg, directory) {
|
|
88148
88146
|
const issues = [];
|
|
@@ -92636,7 +92634,7 @@ function displayInstalledPackage(pkg) {
|
|
|
92636
92634
|
// src/cli/index.ts
|
|
92637
92635
|
init_logger();
|
|
92638
92636
|
init_error_utils();
|
|
92639
|
-
var version2 = true ? "0.21.
|
|
92637
|
+
var version2 = true ? "0.21.6" : "0.0.0-dev";
|
|
92640
92638
|
var program2 = new Command();
|
|
92641
92639
|
program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").option("-v, --version", "Output the current version").option("--no-color", "Disable colors").option("--color", "Force colors").on("option:version", () => {
|
|
92642
92640
|
logger.banner(version2);
|
|
@@ -39,7 +39,7 @@ function checkPackEngineVersion(pkg) {
|
|
|
39
39
|
*/
|
|
40
40
|
function deriveNamespace(packageName) {
|
|
41
41
|
const base = packageName.replace(/^@[^/]+\//, '');
|
|
42
|
-
return base.replace(/^
|
|
42
|
+
return base.replace(/^flow-weaver-pack-/, '');
|
|
43
43
|
}
|
|
44
44
|
export async function registerPackCommands(program) {
|
|
45
45
|
const projectDir = process.cwd();
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.21.
|
|
1
|
+
export declare const VERSION = "0.21.6";
|
|
2
2
|
//# sourceMappingURL=generated-version.d.ts.map
|
|
@@ -10,7 +10,7 @@ import * as path from 'path';
|
|
|
10
10
|
import { glob } from 'glob';
|
|
11
11
|
const MARKETPLACE_KEYWORD = 'flowweaver-marketplace-pack';
|
|
12
12
|
const NPM_SEARCH_URL = 'https://registry.npmjs.org/-/v1/search';
|
|
13
|
-
const PACK_NAME_RE = /^(@[^/]+\/)?
|
|
13
|
+
const PACK_NAME_RE = /^(@[^/]+\/)?flow-weaver-pack-.+$/;
|
|
14
14
|
/**
|
|
15
15
|
* Search the npm registry for marketplace packages.
|
|
16
16
|
*/
|
|
@@ -49,10 +49,8 @@ export async function listInstalledPackages(projectDir) {
|
|
|
49
49
|
const nodeModules = path.join(projectDir, 'node_modules');
|
|
50
50
|
if (!fs.existsSync(nodeModules))
|
|
51
51
|
return [];
|
|
52
|
-
// Look for
|
|
52
|
+
// Look for flow-weaver-pack-* and @*/flow-weaver-pack-* directories
|
|
53
53
|
const patterns = [
|
|
54
|
-
path.join(nodeModules, 'flowweaver-pack-*', 'flowweaver.manifest.json'),
|
|
55
|
-
path.join(nodeModules, '@*', 'flowweaver-pack-*', 'flowweaver.manifest.json'),
|
|
56
54
|
path.join(nodeModules, 'flow-weaver-pack-*', 'flowweaver.manifest.json'),
|
|
57
55
|
path.join(nodeModules, '@*', 'flow-weaver-pack-*', 'flowweaver.manifest.json'),
|
|
58
56
|
];
|
|
@@ -9,7 +9,7 @@ import { parseWorkflow, validateWorkflow } from '../api/index.js';
|
|
|
9
9
|
function issue(code, severity, message) {
|
|
10
10
|
return { code, severity, message };
|
|
11
11
|
}
|
|
12
|
-
const PACK_NAME_RE = /^(@[^/]+\/)?
|
|
12
|
+
const PACK_NAME_RE = /^(@[^/]+\/)?flow-weaver-pack-.+$/;
|
|
13
13
|
const MARKETPLACE_KEYWORD = 'flowweaver-marketplace-pack';
|
|
14
14
|
// ── Package-level rules ──────────────────────────────────────────────────────
|
|
15
15
|
function validatePackageJson(pkg, directory) {
|
|
@@ -696,7 +696,7 @@ flow-weaver export workflow.ts --target inngest --output dist/ --durable-steps
|
|
|
696
696
|
flow-weaver export workflow.ts --target cloudflare --output worker/
|
|
697
697
|
```
|
|
698
698
|
|
|
699
|
-
> Available targets depend on installed `
|
|
699
|
+
> Available targets depend on installed `flow-weaver-pack-*` packages. See [Deployment](deployment) for installation instructions and target-specific details.
|
|
700
700
|
|
|
701
701
|
---
|
|
702
702
|
|
|
@@ -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