@contractspec/example.project-management-sync 1.57.0 → 1.58.0
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/.turbo/turbo-build.log +34 -33
- package/.turbo/turbo-prebuild.log +1 -0
- package/CHANGELOG.md +13 -0
- package/dist/browser/docs/index.js +40 -0
- package/dist/browser/docs/project-management-sync.docblock.js +40 -0
- package/dist/browser/example.js +33 -0
- package/dist/browser/index.js +194 -0
- package/dist/browser/run.js +122 -0
- package/dist/browser/sync.js +122 -0
- package/dist/docs/index.d.ts +2 -1
- package/dist/docs/index.d.ts.map +1 -0
- package/dist/docs/index.js +41 -1
- package/dist/docs/project-management-sync.docblock.d.ts +2 -1
- package/dist/docs/project-management-sync.docblock.d.ts.map +1 -0
- package/dist/docs/project-management-sync.docblock.js +25 -30
- package/dist/example.d.ts +2 -6
- package/dist/example.d.ts.map +1 -1
- package/dist/example.js +32 -44
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +194 -4
- package/dist/node/docs/index.js +40 -0
- package/dist/node/docs/project-management-sync.docblock.js +40 -0
- package/dist/node/example.js +33 -0
- package/dist/node/index.js +194 -0
- package/dist/node/run.js +122 -0
- package/dist/node/sync.js +122 -0
- package/dist/run.d.ts +2 -1
- package/dist/run.d.ts.map +1 -0
- package/dist/run.js +119 -8
- package/dist/sync.d.ts +17 -21
- package/dist/sync.d.ts.map +1 -1
- package/dist/sync.js +107 -91
- package/package.json +69 -26
- package/tsdown.config.js +1 -2
- package/.turbo/turbo-build$colon$bundle.log +0 -33
- package/dist/docs/project-management-sync.docblock.js.map +0 -1
- package/dist/example.js.map +0 -1
- package/dist/run.js.map +0 -1
- package/dist/sync.js.map +0 -1
- package/tsconfig.tsbuildinfo +0 -1
package/dist/sync.js
CHANGED
|
@@ -1,107 +1,123 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
// @bun
|
|
2
|
+
// src/sync.ts
|
|
3
|
+
import {
|
|
4
|
+
JiraProjectManagementProvider,
|
|
5
|
+
LinearProjectManagementProvider,
|
|
6
|
+
NotionProjectManagementProvider
|
|
7
|
+
} from "@contractspec/integration.providers-impls/impls";
|
|
4
8
|
async function syncProjectManagementWorkItems(input) {
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
};
|
|
9
|
+
const items = input.items ?? buildSampleWorkItems();
|
|
10
|
+
const summary = input.summary;
|
|
11
|
+
const dryRun = input.dryRun ?? false;
|
|
12
|
+
if (dryRun) {
|
|
13
|
+
return { summary, items };
|
|
14
|
+
}
|
|
15
|
+
const provider = input.providerClient ?? createProviderFromEnv(input.provider);
|
|
16
|
+
const createdSummary = summary ? await provider.createWorkItem(summary) : undefined;
|
|
17
|
+
const createdItems = await provider.createWorkItems(items);
|
|
18
|
+
return { summary: createdSummary, items: createdItems };
|
|
16
19
|
}
|
|
17
20
|
async function runProjectManagementSyncFromEnv() {
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
21
|
+
const provider = resolveProviderName();
|
|
22
|
+
const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === "true";
|
|
23
|
+
const summary = provider === "notion" ? buildSampleSummary() : undefined;
|
|
24
|
+
return syncProjectManagementWorkItems({
|
|
25
|
+
provider,
|
|
26
|
+
summary,
|
|
27
|
+
dryRun
|
|
28
|
+
});
|
|
25
29
|
}
|
|
26
30
|
function buildSampleWorkItems() {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
31
|
+
return [
|
|
32
|
+
{
|
|
33
|
+
title: "Review onboarding drop-off",
|
|
34
|
+
description: "Analyze activation funnel to identify the highest drop-off step and propose fixes.",
|
|
35
|
+
type: "task",
|
|
36
|
+
priority: "high",
|
|
37
|
+
tags: ["onboarding", "insights"]
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
title: "Ship first-run checklist",
|
|
41
|
+
description: "Create a guided checklist with 3-5 steps to help new users reach first value.",
|
|
42
|
+
type: "task",
|
|
43
|
+
priority: "medium",
|
|
44
|
+
tags: ["activation", "ux"],
|
|
45
|
+
dueDate: new Date("2026-02-15")
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
title: "Define success metrics",
|
|
49
|
+
description: "Agree on activation success metrics and instrument key events.",
|
|
50
|
+
type: "task",
|
|
51
|
+
priority: "low",
|
|
52
|
+
tags: ["analytics", "tracking"]
|
|
53
|
+
}
|
|
54
|
+
];
|
|
51
55
|
}
|
|
52
56
|
function buildSampleSummary() {
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
57
|
+
return {
|
|
58
|
+
title: "Product Intent Summary",
|
|
59
|
+
description: "This summary aggregates the onboarding tasks and highlights the activation improvements to prioritize.",
|
|
60
|
+
type: "summary",
|
|
61
|
+
tags: ["product-intent", "summary"]
|
|
62
|
+
};
|
|
59
63
|
}
|
|
60
64
|
function createProviderFromEnv(provider) {
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
65
|
+
if (provider === "linear") {
|
|
66
|
+
return new LinearProjectManagementProvider({
|
|
67
|
+
apiKey: requireEnv("LINEAR_API_KEY"),
|
|
68
|
+
teamId: requireEnv("LINEAR_TEAM_ID"),
|
|
69
|
+
projectId: process.env.LINEAR_PROJECT_ID,
|
|
70
|
+
stateId: process.env.LINEAR_STATE_ID,
|
|
71
|
+
assigneeId: process.env.LINEAR_ASSIGNEE_ID,
|
|
72
|
+
labelIds: splitList(process.env.LINEAR_LABEL_IDS)
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
if (provider === "jira") {
|
|
76
|
+
return new JiraProjectManagementProvider({
|
|
77
|
+
siteUrl: requireEnv("JIRA_SITE_URL"),
|
|
78
|
+
email: requireEnv("JIRA_EMAIL"),
|
|
79
|
+
apiToken: requireEnv("JIRA_API_TOKEN"),
|
|
80
|
+
projectKey: process.env.JIRA_PROJECT_KEY,
|
|
81
|
+
issueType: process.env.JIRA_ISSUE_TYPE,
|
|
82
|
+
defaultLabels: splitList(process.env.JIRA_DEFAULT_LABELS)
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
return new NotionProjectManagementProvider({
|
|
86
|
+
apiKey: requireEnv("NOTION_API_KEY"),
|
|
87
|
+
databaseId: process.env.NOTION_DATABASE_ID,
|
|
88
|
+
summaryParentPageId: process.env.NOTION_SUMMARY_PARENT_PAGE_ID,
|
|
89
|
+
titleProperty: process.env.NOTION_TITLE_PROPERTY,
|
|
90
|
+
statusProperty: process.env.NOTION_STATUS_PROPERTY,
|
|
91
|
+
priorityProperty: process.env.NOTION_PRIORITY_PROPERTY,
|
|
92
|
+
tagsProperty: process.env.NOTION_TAGS_PROPERTY,
|
|
93
|
+
dueDateProperty: process.env.NOTION_DUE_DATE_PROPERTY,
|
|
94
|
+
descriptionProperty: process.env.NOTION_DESCRIPTION_PROPERTY
|
|
95
|
+
});
|
|
88
96
|
}
|
|
89
97
|
function resolveProviderName() {
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
98
|
+
const raw = (process.env.CONTRACTSPEC_PM_PROVIDER ?? "linear").toLowerCase();
|
|
99
|
+
if (raw === "linear" || raw === "jira" || raw === "notion")
|
|
100
|
+
return raw;
|
|
101
|
+
throw new Error(`Unsupported provider: ${raw}. Use one of: linear, jira, notion`);
|
|
93
102
|
}
|
|
94
103
|
function requireEnv(key) {
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
104
|
+
const value = process.env[key];
|
|
105
|
+
if (!value) {
|
|
106
|
+
throw new Error(`Missing required env var: ${key}`);
|
|
107
|
+
}
|
|
108
|
+
return value;
|
|
98
109
|
}
|
|
99
110
|
function splitList(value) {
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
111
|
+
if (!value)
|
|
112
|
+
return;
|
|
113
|
+
const items = value.split(",").map((item) => item.trim()).filter(Boolean);
|
|
114
|
+
return items.length > 0 ? items : undefined;
|
|
103
115
|
}
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
116
|
+
export {
|
|
117
|
+
syncProjectManagementWorkItems,
|
|
118
|
+
runProjectManagementSyncFromEnv,
|
|
119
|
+
resolveProviderName,
|
|
120
|
+
createProviderFromEnv,
|
|
121
|
+
buildSampleWorkItems,
|
|
122
|
+
buildSampleSummary
|
|
123
|
+
};
|
package/package.json
CHANGED
|
@@ -1,51 +1,94 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@contractspec/example.project-management-sync",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.58.0",
|
|
4
4
|
"description": "Project management sync example: Linear, Jira, and Notion work item creation.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "./dist/index.d.ts",
|
|
7
7
|
"exports": {
|
|
8
|
-
".": "./
|
|
9
|
-
"./docs": "./
|
|
10
|
-
"./docs/
|
|
11
|
-
"./
|
|
12
|
-
"./
|
|
13
|
-
"./
|
|
14
|
-
"
|
|
8
|
+
".": "./src/index.ts",
|
|
9
|
+
"./docs": "./src/docs/index.ts",
|
|
10
|
+
"./docs/index": "./src/docs/index.ts",
|
|
11
|
+
"./docs/project-management-sync.docblock": "./src/docs/project-management-sync.docblock.ts",
|
|
12
|
+
"./example": "./src/example.ts",
|
|
13
|
+
"./run": "./src/run.ts",
|
|
14
|
+
"./sync": "./src/sync.ts"
|
|
15
15
|
},
|
|
16
16
|
"scripts": {
|
|
17
17
|
"publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
|
|
18
18
|
"publish:pkg:canary": "bun publish:pkg --tag canary",
|
|
19
|
-
"build": "bun build:
|
|
20
|
-
"build:bundle": "
|
|
21
|
-
"build:types": "
|
|
22
|
-
"dev": "bun
|
|
19
|
+
"build": "bun run prebuild && bun run build:bundle && bun run build:types",
|
|
20
|
+
"build:bundle": "contractspec-bun-build transpile",
|
|
21
|
+
"build:types": "contractspec-bun-build types",
|
|
22
|
+
"dev": "contractspec-bun-build dev",
|
|
23
23
|
"clean": "rimraf dist .turbo",
|
|
24
24
|
"lint": "bun lint:fix",
|
|
25
25
|
"lint:fix": "eslint src --fix",
|
|
26
26
|
"lint:check": "eslint src",
|
|
27
|
-
"test": "bun test"
|
|
27
|
+
"test": "bun test",
|
|
28
|
+
"prebuild": "contractspec-bun-build prebuild",
|
|
29
|
+
"typecheck": "tsc --noEmit"
|
|
28
30
|
},
|
|
29
31
|
"dependencies": {
|
|
30
|
-
"@contractspec/integration.providers-impls": "1.
|
|
31
|
-
"@contractspec/lib.contracts": "1.
|
|
32
|
+
"@contractspec/integration.providers-impls": "1.58.0",
|
|
33
|
+
"@contractspec/lib.contracts": "1.58.0"
|
|
32
34
|
},
|
|
33
35
|
"devDependencies": {
|
|
34
|
-
"@contractspec/tool.
|
|
35
|
-
"
|
|
36
|
-
"
|
|
37
|
-
"typescript": "^5.9.3"
|
|
36
|
+
"@contractspec/tool.typescript": "1.58.0",
|
|
37
|
+
"typescript": "^5.9.3",
|
|
38
|
+
"@contractspec/tool.bun": "1.57.0"
|
|
38
39
|
},
|
|
39
40
|
"publishConfig": {
|
|
40
41
|
"access": "public",
|
|
41
42
|
"exports": {
|
|
42
|
-
".":
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
43
|
+
".": {
|
|
44
|
+
"types": "./dist/index.d.ts",
|
|
45
|
+
"bun": "./dist/index.js",
|
|
46
|
+
"node": "./dist/node/index.mjs",
|
|
47
|
+
"browser": "./dist/browser/index.js",
|
|
48
|
+
"default": "./dist/index.js"
|
|
49
|
+
},
|
|
50
|
+
"./docs": {
|
|
51
|
+
"types": "./dist/docs/index.d.ts",
|
|
52
|
+
"bun": "./dist/docs/index.js",
|
|
53
|
+
"node": "./dist/node/docs/index.mjs",
|
|
54
|
+
"browser": "./dist/browser/docs/index.js",
|
|
55
|
+
"default": "./dist/docs/index.js"
|
|
56
|
+
},
|
|
57
|
+
"./docs/index": {
|
|
58
|
+
"types": "./dist/docs/index.d.ts",
|
|
59
|
+
"bun": "./dist/docs/index.js",
|
|
60
|
+
"node": "./dist/node/docs/index.mjs",
|
|
61
|
+
"browser": "./dist/browser/docs/index.js",
|
|
62
|
+
"default": "./dist/docs/index.js"
|
|
63
|
+
},
|
|
64
|
+
"./docs/project-management-sync.docblock": {
|
|
65
|
+
"types": "./dist/docs/project-management-sync.docblock.d.ts",
|
|
66
|
+
"bun": "./dist/docs/project-management-sync.docblock.js",
|
|
67
|
+
"node": "./dist/node/docs/project-management-sync.docblock.mjs",
|
|
68
|
+
"browser": "./dist/browser/docs/project-management-sync.docblock.js",
|
|
69
|
+
"default": "./dist/docs/project-management-sync.docblock.js"
|
|
70
|
+
},
|
|
71
|
+
"./example": {
|
|
72
|
+
"types": "./dist/example.d.ts",
|
|
73
|
+
"bun": "./dist/example.js",
|
|
74
|
+
"node": "./dist/node/example.mjs",
|
|
75
|
+
"browser": "./dist/browser/example.js",
|
|
76
|
+
"default": "./dist/example.js"
|
|
77
|
+
},
|
|
78
|
+
"./run": {
|
|
79
|
+
"types": "./dist/run.d.ts",
|
|
80
|
+
"bun": "./dist/run.js",
|
|
81
|
+
"node": "./dist/node/run.mjs",
|
|
82
|
+
"browser": "./dist/browser/run.js",
|
|
83
|
+
"default": "./dist/run.js"
|
|
84
|
+
},
|
|
85
|
+
"./sync": {
|
|
86
|
+
"types": "./dist/sync.d.ts",
|
|
87
|
+
"bun": "./dist/sync.js",
|
|
88
|
+
"node": "./dist/node/sync.mjs",
|
|
89
|
+
"browser": "./dist/browser/sync.js",
|
|
90
|
+
"default": "./dist/sync.js"
|
|
91
|
+
}
|
|
49
92
|
},
|
|
50
93
|
"registry": "https://registry.npmjs.org/"
|
|
51
94
|
},
|
package/tsdown.config.js
CHANGED
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
$ tsdown
|
|
2
|
-
[34mℹ[39m tsdown [2mv0.20.3[22m powered by rolldown [2mv1.0.0-rc.3[22m
|
|
3
|
-
[34mℹ[39m config file: [4m/home/runner/work/contractspec/contractspec/packages/examples/project-management-sync/tsdown.config.js[24m
|
|
4
|
-
[34mℹ[39m entry: [34msrc/example.ts, src/index.ts, src/run.ts, src/sync.ts, src/docs/index.ts, src/docs/project-management-sync.docblock.ts[39m
|
|
5
|
-
[34mℹ[39m target: [34mesnext[39m
|
|
6
|
-
[34mℹ[39m tsconfig: [34mtsconfig.json[39m
|
|
7
|
-
[34mℹ[39m Build start
|
|
8
|
-
[34mℹ[39m Cleaning 19 files
|
|
9
|
-
[34mℹ[39m [2mdist/[22m[1msync.js[22m [2m3.95 kB[22m [2m│ gzip: 1.53 kB[22m
|
|
10
|
-
[34mℹ[39m [2mdist/[22m[1mdocs/project-management-sync.docblock.js[22m [2m1.60 kB[22m [2m│ gzip: 0.77 kB[22m
|
|
11
|
-
[34mℹ[39m [2mdist/[22m[1mexample.js[22m [2m1.04 kB[22m [2m│ gzip: 0.52 kB[22m
|
|
12
|
-
[34mℹ[39m [2mdist/[22m[1mindex.js[22m [2m0.41 kB[22m [2m│ gzip: 0.18 kB[22m
|
|
13
|
-
[34mℹ[39m [2mdist/[22m[1mrun.js[22m [2m0.30 kB[22m [2m│ gzip: 0.22 kB[22m
|
|
14
|
-
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m [2m0.05 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
15
|
-
[34mℹ[39m [2mdist/[22msync.js.map [2m7.29 kB[22m [2m│ gzip: 2.43 kB[22m
|
|
16
|
-
[34mℹ[39m [2mdist/[22mdocs/project-management-sync.docblock.js.map [2m2.12 kB[22m [2m│ gzip: 0.97 kB[22m
|
|
17
|
-
[34mℹ[39m [2mdist/[22mexample.js.map [2m1.51 kB[22m [2m│ gzip: 0.72 kB[22m
|
|
18
|
-
[34mℹ[39m [2mdist/[22msync.d.ts.map [2m0.57 kB[22m [2m│ gzip: 0.28 kB[22m
|
|
19
|
-
[34mℹ[39m [2mdist/[22mrun.js.map [2m0.50 kB[22m [2m│ gzip: 0.34 kB[22m
|
|
20
|
-
[34mℹ[39m [2mdist/[22mexample.d.ts.map [2m0.13 kB[22m [2m│ gzip: 0.13 kB[22m
|
|
21
|
-
[34mℹ[39m [2mdist/[22m[32m[1msync.d.ts[22m[39m [2m1.52 kB[22m [2m│ gzip: 0.44 kB[22m
|
|
22
|
-
[34mℹ[39m [2mdist/[22m[32m[1mindex.d.ts[22m[39m [2m0.56 kB[22m [2m│ gzip: 0.19 kB[22m
|
|
23
|
-
[34mℹ[39m [2mdist/[22m[32m[1mexample.d.ts[22m[39m [2m0.25 kB[22m [2m│ gzip: 0.17 kB[22m
|
|
24
|
-
[34mℹ[39m [2mdist/[22m[32m[1mdocs/index.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
25
|
-
[34mℹ[39m [2mdist/[22m[32m[1mdocs/project-management-sync.docblock.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
26
|
-
[34mℹ[39m [2mdist/[22m[32m[1mrun.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
27
|
-
[34mℹ[39m 18 files, total: 21.83 kB
|
|
28
|
-
[33m[PLUGIN_TIMINGS] Warning:[0m Your build spent significant time in plugins. Here is a breakdown:
|
|
29
|
-
- rolldown-plugin-dts:generate (50%)
|
|
30
|
-
- tsdown:external (50%)
|
|
31
|
-
See https://rolldown.rs/options/checks#plugintimings for more details.
|
|
32
|
-
|
|
33
|
-
[32m✔[39m Build complete in [32m42785ms[39m
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"project-management-sync.docblock.js","names":[],"sources":["../../src/docs/project-management-sync.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n {\n id: 'docs.examples.project-management-sync',\n title: 'Project Management Sync (example)',\n summary:\n 'Create a shared payload of work items and sync it to Linear, Jira Cloud, or Notion.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/examples/project-management-sync',\n tags: ['project-management', 'linear', 'jira', 'notion', 'example'],\n body: `## What this example shows\n- Build a provider-agnostic payload of work items.\n- Resolve the target provider from environment variables.\n- Run in dry-run mode for preview output.\n\n## Guardrails\n- Keep secrets in env or secret providers only.\n- Use dry-run to validate payloads before writing.\n- Start with a small batch of tasks to validate setup.`,\n },\n {\n id: 'docs.examples.project-management-sync.usage',\n title: 'Project Management Sync - Usage',\n summary: 'How to run the sync with env-driven provider settings.',\n kind: 'usage',\n visibility: 'public',\n route: '/docs/examples/project-management-sync/usage',\n tags: ['project-management', 'usage'],\n body: `## Usage\n- Set CONTRACTSPEC_PM_PROVIDER to linear, jira, or notion.\n- Set CONTRACTSPEC_PM_DRY_RUN=true to preview payloads.\n- Provide provider-specific env vars (API keys, project IDs).\n\n## Example\n- Call runProjectManagementSyncFromEnv() from sync.ts or import it in your app.\n- The helper builds a sample payload and calls the provider client.`,\n },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA0CA,kBAvC2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAsB;EAAU;EAAQ;EAAU;EAAU;CACnE,MAAM;;;;;;;;;CASP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sBAAsB,QAAQ;CACrC,MAAM;;;;;;;;CAQP,CACF,CAEwB"}
|
package/dist/example.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n meta: {\n key: 'project-management-sync',\n version: '1.0.0',\n title: 'Project Management Sync',\n description:\n 'Create project-management work items in Linear, Jira Cloud, or Notion from a shared payload.',\n kind: 'integration',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.integrations'],\n tags: ['project-management', 'linear', 'jira', 'notion', 'integrations'],\n },\n docs: {\n rootDocId: 'docs.examples.project-management-sync',\n usageDocId: 'docs.examples.project-management-sync.usage',\n },\n entrypoints: {\n packageName: '@contractspec/example.project-management-sync',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,yBAAyB;EAClC,MAAM;GAAC;GAAsB;GAAU;GAAQ;GAAU;GAAe;EACzE;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}
|
package/dist/run.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["import { runProjectManagementSyncFromEnv } from './sync';\n\nrunProjectManagementSyncFromEnv()\n .then((result) => {\n console.log(JSON.stringify(result, null, 2));\n })\n .catch((error) => {\n console.error(error);\n process.exitCode = 1;\n });\n"],"mappings":";;;AAEA,iCAAiC,CAC9B,MAAM,WAAW;AAChB,SAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;EAC5C,CACD,OAAO,UAAU;AAChB,SAAQ,MAAM,MAAM;AACpB,SAAQ,WAAW;EACnB"}
|
package/dist/sync.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"sync.js","names":[],"sources":["../src/sync.ts"],"sourcesContent":["import {\n JiraProjectManagementProvider,\n LinearProjectManagementProvider,\n NotionProjectManagementProvider,\n} from '@contractspec/integration.providers-impls/impls';\nimport type {\n ProjectManagementProvider,\n ProjectManagementWorkItem,\n ProjectManagementWorkItemInput,\n} from '@contractspec/integration.providers-impls/project-management';\n\nexport type ProjectManagementProviderName = 'linear' | 'jira' | 'notion';\n\nexport interface ProjectManagementSyncInput {\n provider: ProjectManagementProviderName;\n providerClient?: ProjectManagementProvider;\n items?: ProjectManagementWorkItemInput[];\n summary?: ProjectManagementWorkItemInput;\n dryRun?: boolean;\n}\n\nexport interface ProjectManagementSyncOutput {\n summary?: ProjectManagementWorkItem | ProjectManagementWorkItemInput;\n items: ProjectManagementWorkItem[] | ProjectManagementWorkItemInput[];\n}\n\nexport async function syncProjectManagementWorkItems(\n input: ProjectManagementSyncInput\n): Promise<ProjectManagementSyncOutput> {\n const items = input.items ?? buildSampleWorkItems();\n const summary = input.summary;\n const dryRun = input.dryRun ?? false;\n\n if (dryRun) {\n return { summary, items };\n }\n\n const provider =\n input.providerClient ?? createProviderFromEnv(input.provider);\n const createdSummary = summary\n ? await provider.createWorkItem(summary)\n : undefined;\n const createdItems = await provider.createWorkItems(items);\n return { summary: createdSummary, items: createdItems };\n}\n\nexport async function runProjectManagementSyncFromEnv(): Promise<ProjectManagementSyncOutput> {\n const provider = resolveProviderName();\n const dryRun = process.env.CONTRACTSPEC_PM_DRY_RUN === 'true';\n const summary = provider === 'notion' ? buildSampleSummary() : undefined;\n return syncProjectManagementWorkItems({\n provider,\n summary,\n dryRun,\n });\n}\n\nexport function buildSampleWorkItems(): ProjectManagementWorkItemInput[] {\n return [\n {\n title: 'Review onboarding drop-off',\n description:\n 'Analyze activation funnel to identify the highest drop-off step and propose fixes.',\n type: 'task',\n priority: 'high',\n tags: ['onboarding', 'insights'],\n },\n {\n title: 'Ship first-run checklist',\n description:\n 'Create a guided checklist with 3-5 steps to help new users reach first value.',\n type: 'task',\n priority: 'medium',\n tags: ['activation', 'ux'],\n dueDate: new Date('2026-02-15'),\n },\n {\n title: 'Define success metrics',\n description:\n 'Agree on activation success metrics and instrument key events.',\n type: 'task',\n priority: 'low',\n tags: ['analytics', 'tracking'],\n },\n ];\n}\n\nexport function buildSampleSummary(): ProjectManagementWorkItemInput {\n return {\n title: 'Product Intent Summary',\n description:\n 'This summary aggregates the onboarding tasks and highlights the activation improvements to prioritize.',\n type: 'summary',\n tags: ['product-intent', 'summary'],\n };\n}\n\nexport function createProviderFromEnv(\n provider: ProjectManagementProviderName\n): ProjectManagementProvider {\n if (provider === 'linear') {\n return new LinearProjectManagementProvider({\n apiKey: requireEnv('LINEAR_API_KEY'),\n teamId: requireEnv('LINEAR_TEAM_ID'),\n projectId: process.env.LINEAR_PROJECT_ID,\n stateId: process.env.LINEAR_STATE_ID,\n assigneeId: process.env.LINEAR_ASSIGNEE_ID,\n labelIds: splitList(process.env.LINEAR_LABEL_IDS),\n });\n }\n\n if (provider === 'jira') {\n return new JiraProjectManagementProvider({\n siteUrl: requireEnv('JIRA_SITE_URL'),\n email: requireEnv('JIRA_EMAIL'),\n apiToken: requireEnv('JIRA_API_TOKEN'),\n projectKey: process.env.JIRA_PROJECT_KEY,\n issueType: process.env.JIRA_ISSUE_TYPE,\n defaultLabels: splitList(process.env.JIRA_DEFAULT_LABELS),\n });\n }\n\n return new NotionProjectManagementProvider({\n apiKey: requireEnv('NOTION_API_KEY'),\n databaseId: process.env.NOTION_DATABASE_ID,\n summaryParentPageId: process.env.NOTION_SUMMARY_PARENT_PAGE_ID,\n titleProperty: process.env.NOTION_TITLE_PROPERTY,\n statusProperty: process.env.NOTION_STATUS_PROPERTY,\n priorityProperty: process.env.NOTION_PRIORITY_PROPERTY,\n tagsProperty: process.env.NOTION_TAGS_PROPERTY,\n dueDateProperty: process.env.NOTION_DUE_DATE_PROPERTY,\n descriptionProperty: process.env.NOTION_DESCRIPTION_PROPERTY,\n });\n}\n\nexport function resolveProviderName(): ProjectManagementProviderName {\n const raw = (process.env.CONTRACTSPEC_PM_PROVIDER ?? 'linear').toLowerCase();\n if (raw === 'linear' || raw === 'jira' || raw === 'notion') return raw;\n throw new Error(\n `Unsupported provider: ${raw}. Use one of: linear, jira, notion`\n );\n}\n\nfunction requireEnv(key: string): string {\n const value = process.env[key];\n if (!value) {\n throw new Error(`Missing required env var: ${key}`);\n }\n return value;\n}\n\nfunction splitList(value?: string): string[] | undefined {\n if (!value) return undefined;\n const items = value\n .split(',')\n .map((item) => item.trim())\n .filter(Boolean);\n return items.length > 0 ? items : undefined;\n}\n"],"mappings":";;;AA0BA,eAAsB,+BACpB,OACsC;CACtC,MAAM,QAAQ,MAAM,SAAS,sBAAsB;CACnD,MAAM,UAAU,MAAM;AAGtB,KAFe,MAAM,UAAU,MAG7B,QAAO;EAAE;EAAS;EAAO;CAG3B,MAAM,WACJ,MAAM,kBAAkB,sBAAsB,MAAM,SAAS;AAK/D,QAAO;EAAE,SAJc,UACnB,MAAM,SAAS,eAAe,QAAQ,GACtC;EAE8B,OADb,MAAM,SAAS,gBAAgB,MAAM;EACH;;AAGzD,eAAsB,kCAAwE;CAC5F,MAAM,WAAW,qBAAqB;CACtC,MAAM,SAAS,QAAQ,IAAI,4BAA4B;AAEvD,QAAO,+BAA+B;EACpC;EACA,SAHc,aAAa,WAAW,oBAAoB,GAAG;EAI7D;EACD,CAAC;;AAGJ,SAAgB,uBAAyD;AACvE,QAAO;EACL;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,cAAc,WAAW;GACjC;EACD;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,cAAc,KAAK;GAC1B,yBAAS,IAAI,KAAK,aAAa;GAChC;EACD;GACE,OAAO;GACP,aACE;GACF,MAAM;GACN,UAAU;GACV,MAAM,CAAC,aAAa,WAAW;GAChC;EACF;;AAGH,SAAgB,qBAAqD;AACnE,QAAO;EACL,OAAO;EACP,aACE;EACF,MAAM;EACN,MAAM,CAAC,kBAAkB,UAAU;EACpC;;AAGH,SAAgB,sBACd,UAC2B;AAC3B,KAAI,aAAa,SACf,QAAO,IAAI,gCAAgC;EACzC,QAAQ,WAAW,iBAAiB;EACpC,QAAQ,WAAW,iBAAiB;EACpC,WAAW,QAAQ,IAAI;EACvB,SAAS,QAAQ,IAAI;EACrB,YAAY,QAAQ,IAAI;EACxB,UAAU,UAAU,QAAQ,IAAI,iBAAiB;EAClD,CAAC;AAGJ,KAAI,aAAa,OACf,QAAO,IAAI,8BAA8B;EACvC,SAAS,WAAW,gBAAgB;EACpC,OAAO,WAAW,aAAa;EAC/B,UAAU,WAAW,iBAAiB;EACtC,YAAY,QAAQ,IAAI;EACxB,WAAW,QAAQ,IAAI;EACvB,eAAe,UAAU,QAAQ,IAAI,oBAAoB;EAC1D,CAAC;AAGJ,QAAO,IAAI,gCAAgC;EACzC,QAAQ,WAAW,iBAAiB;EACpC,YAAY,QAAQ,IAAI;EACxB,qBAAqB,QAAQ,IAAI;EACjC,eAAe,QAAQ,IAAI;EAC3B,gBAAgB,QAAQ,IAAI;EAC5B,kBAAkB,QAAQ,IAAI;EAC9B,cAAc,QAAQ,IAAI;EAC1B,iBAAiB,QAAQ,IAAI;EAC7B,qBAAqB,QAAQ,IAAI;EAClC,CAAC;;AAGJ,SAAgB,sBAAqD;CACnE,MAAM,OAAO,QAAQ,IAAI,4BAA4B,UAAU,aAAa;AAC5E,KAAI,QAAQ,YAAY,QAAQ,UAAU,QAAQ,SAAU,QAAO;AACnE,OAAM,IAAI,MACR,yBAAyB,IAAI,oCAC9B;;AAGH,SAAS,WAAW,KAAqB;CACvC,MAAM,QAAQ,QAAQ,IAAI;AAC1B,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,6BAA6B,MAAM;AAErD,QAAO;;AAGT,SAAS,UAAU,OAAsC;AACvD,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,QAAQ,MACX,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ;AAClB,QAAO,MAAM,SAAS,IAAI,QAAQ"}
|