@getbrevo/cli 1.0.0 → 1.1.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.
Files changed (131) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +26 -51
  3. package/agent-context/AGENTS.md +70 -10
  4. package/agent-context/SKILL.md +51 -3
  5. package/dist/api/client.d.ts +1 -1
  6. package/dist/api/client.d.ts.map +1 -1
  7. package/dist/api/client.js +4 -2
  8. package/dist/api/client.js.map +1 -1
  9. package/dist/bin/index.js +31 -19
  10. package/dist/bin/index.js.map +1 -1
  11. package/dist/commands/app/create.d.ts +1 -0
  12. package/dist/commands/app/create.d.ts.map +1 -1
  13. package/dist/commands/app/create.js +57 -20
  14. package/dist/commands/app/create.js.map +1 -1
  15. package/dist/commands/app/credentials.d.ts.map +1 -1
  16. package/dist/commands/app/credentials.js +73 -71
  17. package/dist/commands/app/credentials.js.map +1 -1
  18. package/dist/commands/app/delete.d.ts.map +1 -1
  19. package/dist/commands/app/delete.js +9 -8
  20. package/dist/commands/app/delete.js.map +1 -1
  21. package/dist/commands/app/list.d.ts.map +1 -1
  22. package/dist/commands/app/list.js +1 -0
  23. package/dist/commands/app/list.js.map +1 -1
  24. package/dist/commands/app/scaffold.d.ts.map +1 -1
  25. package/dist/commands/app/scaffold.js +71 -71
  26. package/dist/commands/app/scaffold.js.map +1 -1
  27. package/dist/commands/app/scopes.d.ts +2 -0
  28. package/dist/commands/app/scopes.d.ts.map +1 -0
  29. package/dist/commands/app/scopes.js +79 -0
  30. package/dist/commands/app/scopes.js.map +1 -0
  31. package/dist/commands/app/start.d.ts.map +1 -1
  32. package/dist/commands/app/start.js +38 -48
  33. package/dist/commands/app/start.js.map +1 -1
  34. package/dist/commands/app/update.d.ts.map +1 -1
  35. package/dist/commands/app/update.js +90 -5
  36. package/dist/commands/app/update.js.map +1 -1
  37. package/dist/commands/definitions.d.ts +1 -0
  38. package/dist/commands/definitions.d.ts.map +1 -1
  39. package/dist/commands/definitions.js +67 -2
  40. package/dist/commands/definitions.js.map +1 -1
  41. package/dist/commands/init.d.ts.map +1 -1
  42. package/dist/commands/init.js +73 -57
  43. package/dist/commands/init.js.map +1 -1
  44. package/dist/commands/login.d.ts.map +1 -1
  45. package/dist/commands/login.js +50 -38
  46. package/dist/commands/login.js.map +1 -1
  47. package/dist/commands/skill/install.d.ts +4 -0
  48. package/dist/commands/skill/install.d.ts.map +1 -0
  49. package/dist/commands/skill/install.js +29 -0
  50. package/dist/commands/skill/install.js.map +1 -0
  51. package/dist/commands/skill/uninstall.d.ts +4 -0
  52. package/dist/commands/skill/uninstall.d.ts.map +1 -0
  53. package/dist/commands/skill/uninstall.js +23 -0
  54. package/dist/commands/skill/uninstall.js.map +1 -0
  55. package/dist/commands/whoami.d.ts.map +1 -1
  56. package/dist/commands/whoami.js +5 -1
  57. package/dist/commands/whoami.js.map +1 -1
  58. package/dist/lang/en.d.ts +30 -2
  59. package/dist/lang/en.d.ts.map +1 -1
  60. package/dist/lang/en.js +32 -2
  61. package/dist/lang/en.js.map +1 -1
  62. package/dist/lib/auth-guard.d.ts.map +1 -1
  63. package/dist/lib/auth-guard.js +8 -2
  64. package/dist/lib/auth-guard.js.map +1 -1
  65. package/dist/lib/browser.js +4 -4
  66. package/dist/lib/browser.js.map +1 -1
  67. package/dist/lib/cli-version.d.ts +2 -0
  68. package/dist/lib/cli-version.d.ts.map +1 -0
  69. package/dist/lib/cli-version.js +59 -0
  70. package/dist/lib/cli-version.js.map +1 -0
  71. package/dist/lib/command-registry.js +1 -1
  72. package/dist/lib/command-registry.js.map +1 -1
  73. package/dist/lib/config.d.ts +3 -1
  74. package/dist/lib/config.d.ts.map +1 -1
  75. package/dist/lib/config.js +41 -7
  76. package/dist/lib/config.js.map +1 -1
  77. package/dist/lib/constants.d.ts +6 -1
  78. package/dist/lib/constants.d.ts.map +1 -1
  79. package/dist/lib/constants.js +16 -8
  80. package/dist/lib/constants.js.map +1 -1
  81. package/dist/lib/hidden-input.js +1 -1
  82. package/dist/lib/hidden-input.js.map +1 -1
  83. package/dist/lib/logger.d.ts.map +1 -1
  84. package/dist/lib/logger.js +14 -4
  85. package/dist/lib/logger.js.map +1 -1
  86. package/dist/lib/update-notifier.d.ts.map +1 -1
  87. package/dist/lib/update-notifier.js +11 -11
  88. package/dist/lib/update-notifier.js.map +1 -1
  89. package/dist/lib/validators.d.ts +17 -0
  90. package/dist/lib/validators.d.ts.map +1 -1
  91. package/dist/lib/validators.js +65 -0
  92. package/dist/lib/validators.js.map +1 -1
  93. package/dist/services/app.d.ts +3 -0
  94. package/dist/services/app.d.ts.map +1 -1
  95. package/dist/services/app.js +6 -1
  96. package/dist/services/app.js.map +1 -1
  97. package/dist/services/browser-auth.js +9 -8
  98. package/dist/services/browser-auth.js.map +1 -1
  99. package/dist/services/oauth-metadata.d.ts +7 -0
  100. package/dist/services/oauth-metadata.d.ts.map +1 -0
  101. package/dist/services/oauth-metadata.js +43 -0
  102. package/dist/services/oauth-metadata.js.map +1 -0
  103. package/dist/services/scopes-html.d.ts +3 -0
  104. package/dist/services/scopes-html.d.ts.map +1 -0
  105. package/dist/services/scopes-html.js +337 -0
  106. package/dist/services/scopes-html.js.map +1 -0
  107. package/dist/services/scopes-web.d.ts +12 -0
  108. package/dist/services/scopes-web.d.ts.map +1 -0
  109. package/dist/services/scopes-web.js +95 -0
  110. package/dist/services/scopes-web.js.map +1 -0
  111. package/dist/services/skill.d.ts +48 -0
  112. package/dist/services/skill.d.ts.map +1 -0
  113. package/dist/services/skill.js +223 -0
  114. package/dist/services/skill.js.map +1 -0
  115. package/dist/skills/index.d.ts +47 -0
  116. package/dist/skills/index.d.ts.map +1 -0
  117. package/dist/skills/index.js +61 -0
  118. package/dist/skills/index.js.map +1 -0
  119. package/dist/templates/files/AGENTS.md.tmpl +6 -1
  120. package/dist/templates/files/CLAUDE.md.tmpl +2 -2
  121. package/dist/templates/files/README.md.tmpl +3 -1
  122. package/dist/templates/files/app-config.json.tmpl +1 -1
  123. package/dist/templates/index.js +2 -2
  124. package/dist/templates/index.js.map +1 -1
  125. package/dist/types.d.ts +2 -0
  126. package/dist/types.d.ts.map +1 -1
  127. package/package.json +4 -3
  128. package/dist/lib/min-version-check.d.ts +0 -15
  129. package/dist/lib/min-version-check.d.ts.map +0 -1
  130. package/dist/lib/min-version-check.js +0 -33
  131. package/dist/lib/min-version-check.js.map +0 -1
@@ -0,0 +1,95 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.startScopesWebServer = startScopesWebServer;
37
+ const http = __importStar(require("node:http"));
38
+ const scopes_html_1 = require("./scopes-html");
39
+ const logger_1 = require("../lib/logger");
40
+ function closeServer(server) {
41
+ return new Promise((resolveClose) => {
42
+ server.close(() => resolveClose());
43
+ });
44
+ }
45
+ function startScopesWebServer(initialEntries, options = {}) {
46
+ const html = (0, scopes_html_1.renderScopesHtml)(initialEntries);
47
+ const refetch = options.refetch;
48
+ return new Promise((resolve, reject) => {
49
+ const server = http.createServer((req, res) => {
50
+ const pathname = new URL(req.url ?? '/', 'http://127.0.0.1').pathname;
51
+ (0, logger_1.logDebug)('scopes-web request', { method: req.method, pathname });
52
+ if (req.method === 'GET' && pathname === '/') {
53
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
54
+ res.end(html);
55
+ return;
56
+ }
57
+ if (req.method === 'GET' && pathname === '/scopes.json') {
58
+ const respond = (entries) => {
59
+ res.writeHead(200, {
60
+ 'Content-Type': 'application/json; charset=utf-8',
61
+ 'Cache-Control': 'no-store',
62
+ });
63
+ res.end(JSON.stringify({ scopes: entries }));
64
+ };
65
+ if (!refetch) {
66
+ respond(initialEntries);
67
+ return;
68
+ }
69
+ refetch()
70
+ .then(respond)
71
+ .catch((err) => {
72
+ (0, logger_1.logDebug)('scopes-web refetch failed', { message: err.message });
73
+ res.writeHead(502, { 'Content-Type': 'application/json; charset=utf-8' });
74
+ res.end(JSON.stringify({ error: 'refetch_failed' }));
75
+ });
76
+ return;
77
+ }
78
+ res.writeHead(404).end();
79
+ });
80
+ server.once('error', (err) => {
81
+ (0, logger_1.logDebug)('scopes-web server error', { message: err.message });
82
+ reject(err);
83
+ });
84
+ server.listen(0, '127.0.0.1', () => {
85
+ const port = server.address().port;
86
+ const url = `http://127.0.0.1:${port}/`;
87
+ (0, logger_1.logDebug)('scopes-web listening', { host: '127.0.0.1', port });
88
+ resolve({
89
+ url,
90
+ close: () => closeServer(server),
91
+ });
92
+ });
93
+ });
94
+ }
95
+ //# sourceMappingURL=scopes-web.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopes-web.js","sourceRoot":"","sources":["../../src/services/scopes-web.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ export declare function getClaudeSkillsRoot(): string;
2
+ export type InstallStatus = 'installed' | 'already-installed' | 'overwritten';
3
+ export interface InstallResult {
4
+ name: string;
5
+ version: string;
6
+ status: InstallStatus;
7
+ path: string;
8
+ }
9
+ export interface UninstallResult {
10
+ name: string;
11
+ path: string;
12
+ }
13
+ export interface OutdatedSkill {
14
+ name: string;
15
+ installedVersion: string;
16
+ latestVersion: string;
17
+ }
18
+ export declare const skillService: {
19
+ /**
20
+ * Installed skills whose marker version is behind the bundled catalog.
21
+ * Pure file read — safe to call on every CLI invocation for auto-refresh.
22
+ */
23
+ getOutdatedSkills(): OutdatedSkill[];
24
+ /** True when the named skill is installed (marker present). */
25
+ isInstalled(name: string): boolean;
26
+ install(name: string, options?: {
27
+ force?: boolean;
28
+ }): InstallResult;
29
+ installAll(options?: {
30
+ force?: boolean;
31
+ }): InstallResult[];
32
+ uninstallAll(): UninstallResult[];
33
+ /**
34
+ * Refresh installed skills whose marker version drifts from the bundled
35
+ * catalog. Pure local file ops — safe to call after every CLI invocation.
36
+ * Errors during the refresh emit a single error line and never throw,
37
+ * so a broken refresh can't block the user's actual command.
38
+ */
39
+ autoRefreshOutdated(opts?: AutoRefreshOptions): void;
40
+ };
41
+ export type SkillService = typeof skillService;
42
+ export interface AutoRefreshOptions {
43
+ argv?: readonly string[];
44
+ env?: NodeJS.ProcessEnv;
45
+ output?: NodeJS.WriteStream;
46
+ }
47
+ export declare function shouldSkipAutoRefresh(opts?: AutoRefreshOptions): boolean;
48
+ //# sourceMappingURL=skill.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/services/skill.ts"],"names":[],"mappings":"AAaA,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAwED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,mBAAmB,GAAG,aAAa,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,YAAY;IACvB;;;OAGG;yBACkB,aAAa,EAAE;IAepC,+DAA+D;sBAC7C,MAAM,GAAG,OAAO;kBAMpB,MAAM,YAAW;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAQ,aAAa;yBA6BnD;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAQ,aAAa,EAAE;oBAI9C,eAAe,EAAE;IASjC;;;;;OAKG;+BACuB,kBAAkB,GAAQ,IAAI;CAwBzD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAM/C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAgB5E"}
@@ -0,0 +1,223 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.skillService = void 0;
37
+ exports.getClaudeSkillsRoot = getClaudeSkillsRoot;
38
+ exports.shouldSkipAutoRefresh = shouldSkipAutoRefresh;
39
+ const fs = __importStar(require("node:fs"));
40
+ const path = __importStar(require("node:path"));
41
+ const os = __importStar(require("node:os"));
42
+ const en_1 = require("../lang/en");
43
+ const errors_1 = require("../lib/errors");
44
+ const skills_1 = require("../skills");
45
+ // ──────────────── Target directory ────────────────
46
+ // Claude Code reads skills from `~/.claude/skills/<name>/`. The path is
47
+ // overridable via BREVO_CLAUDE_HOME so tests (and future Cursor support)
48
+ // can target a different root without monkey-patching `os.homedir`.
49
+ function getClaudeSkillsRoot() {
50
+ const override = process.env.BREVO_CLAUDE_HOME;
51
+ if (override && override.trim()) {
52
+ return path.join(override, 'skills');
53
+ }
54
+ return path.join(os.homedir(), '.claude', 'skills');
55
+ }
56
+ function getSkillTargetDir(name) {
57
+ return path.join(getClaudeSkillsRoot(), name);
58
+ }
59
+ // ──────────────── Install marker ────────────────
60
+ // A `.brevo-skill.json` file inside each installed skill records the version
61
+ // and source. It lets the auto-refresh pass decide whether a refresh is needed
62
+ // and lets `brevo skill:cli uninstall` confirm we only delete directories the CLI
63
+ // created — never something the user dropped in `~/.claude/skills/` manually.
64
+ const MARKER_FILE = '.brevo-skill.json';
65
+ function readMarker(skillDir) {
66
+ try {
67
+ const raw = JSON.parse(fs.readFileSync(path.join(skillDir, MARKER_FILE), 'utf-8'));
68
+ if (raw &&
69
+ typeof raw === 'object' &&
70
+ typeof raw.name === 'string' &&
71
+ typeof raw.version === 'string' &&
72
+ raw.source === 'brevo-cli') {
73
+ return {
74
+ name: raw.name,
75
+ version: raw.version,
76
+ installedAt: typeof raw.installedAt === 'string' ? raw.installedAt : '',
77
+ source: 'brevo-cli',
78
+ };
79
+ }
80
+ return null;
81
+ }
82
+ catch {
83
+ return null;
84
+ }
85
+ }
86
+ function writeMarker(skillDir, entry) {
87
+ const marker = {
88
+ name: entry.name,
89
+ version: entry.version,
90
+ installedAt: new Date().toISOString(),
91
+ source: 'brevo-cli',
92
+ };
93
+ fs.writeFileSync(path.join(skillDir, MARKER_FILE), JSON.stringify(marker, null, 2) + '\n', 'utf-8');
94
+ }
95
+ // ──────────────── File copy ────────────────
96
+ function copySkillFiles(entry, targetDir) {
97
+ fs.mkdirSync(targetDir, { recursive: true });
98
+ for (const relative of entry.files) {
99
+ const src = path.join(skills_1.SKILLS_BUNDLE_DIR, entry.subdir, relative);
100
+ const dest = path.join(targetDir, relative);
101
+ fs.mkdirSync(path.dirname(dest), { recursive: true });
102
+ fs.copyFileSync(src, dest);
103
+ }
104
+ }
105
+ exports.skillService = {
106
+ /**
107
+ * Installed skills whose marker version is behind the bundled catalog.
108
+ * Pure file read — safe to call on every CLI invocation for auto-refresh.
109
+ */
110
+ getOutdatedSkills() {
111
+ return skills_1.SKILL_CATALOG.flatMap((entry) => {
112
+ const marker = readMarker(getSkillTargetDir(entry.name));
113
+ if (!marker)
114
+ return [];
115
+ if (marker.version === entry.version)
116
+ return [];
117
+ return [
118
+ {
119
+ name: entry.name,
120
+ installedVersion: marker.version,
121
+ latestVersion: entry.version,
122
+ },
123
+ ];
124
+ });
125
+ },
126
+ /** True when the named skill is installed (marker present). */
127
+ isInstalled(name) {
128
+ const entry = (0, skills_1.getSkill)(name);
129
+ if (!entry)
130
+ return false;
131
+ return readMarker(getSkillTargetDir(entry.name)) !== null;
132
+ },
133
+ install(name, options = {}) {
134
+ const entry = (0, skills_1.getSkill)(name);
135
+ if (!entry) {
136
+ throw new errors_1.CliError(unknownSkillMessage(name));
137
+ }
138
+ const targetDir = getSkillTargetDir(entry.name);
139
+ const marker = readMarker(targetDir);
140
+ if (marker && !options.force) {
141
+ return {
142
+ name: entry.name,
143
+ version: marker.version,
144
+ status: 'already-installed',
145
+ path: targetDir,
146
+ };
147
+ }
148
+ copySkillFiles(entry, targetDir);
149
+ writeMarker(targetDir, entry);
150
+ return {
151
+ name: entry.name,
152
+ version: entry.version,
153
+ status: marker ? 'overwritten' : 'installed',
154
+ path: targetDir,
155
+ };
156
+ },
157
+ installAll(options = {}) {
158
+ return skills_1.SKILL_CATALOG.map((entry) => this.install(entry.name, options));
159
+ },
160
+ uninstallAll() {
161
+ return skills_1.SKILL_CATALOG.flatMap((entry) => {
162
+ const targetDir = getSkillTargetDir(entry.name);
163
+ if (!readMarker(targetDir))
164
+ return [];
165
+ fs.rmSync(targetDir, { recursive: true, force: true });
166
+ return [{ name: entry.name, path: targetDir }];
167
+ });
168
+ },
169
+ /**
170
+ * Refresh installed skills whose marker version drifts from the bundled
171
+ * catalog. Pure local file ops — safe to call after every CLI invocation.
172
+ * Errors during the refresh emit a single error line and never throw,
173
+ * so a broken refresh can't block the user's actual command.
174
+ */
175
+ autoRefreshOutdated(opts = {}) {
176
+ if (shouldSkipAutoRefresh(opts))
177
+ return;
178
+ let outdated;
179
+ try {
180
+ outdated = this.getOutdatedSkills();
181
+ }
182
+ catch {
183
+ return;
184
+ }
185
+ if (outdated.length === 0)
186
+ return;
187
+ const output = opts.output ?? process.stderr;
188
+ for (const s of outdated) {
189
+ try {
190
+ this.install(s.name, { force: true });
191
+ output.write(` ${en_1.messages.SKILL_AUTOREFRESHED(s.name, s.installedVersion, s.latestVersion)}\n`);
192
+ }
193
+ catch (err) {
194
+ const msg = err instanceof Error ? err.message : String(err);
195
+ output.write(` ${en_1.messages.SKILL_AUTOREFRESH_FAILED(s.name, msg)}\n`);
196
+ }
197
+ }
198
+ },
199
+ };
200
+ function shouldSkipAutoRefresh(opts = {}) {
201
+ const env = opts.env ?? process.env;
202
+ const argv = opts.argv ?? process.argv;
203
+ // CI runners shouldn't have surprise mutations to ~/.claude.
204
+ if (env.CI === 'true' || env.CI === '1')
205
+ return true;
206
+ // --json callers want deterministic, machine-readable output.
207
+ if (argv.includes('--json'))
208
+ return true;
209
+ // The user is already managing skills — let their explicit command do the work.
210
+ if (argv.length > 2 && argv[2] === 'skill:cli')
211
+ return true;
212
+ // Dedicated opt-out for users who hand-edit their installed SKILL.md and
213
+ // don't want it clobbered on the next `brevo` run.
214
+ if (env.BREVO_NO_SKILL_AUTOREFRESH === '1' || env.BREVO_NO_SKILL_AUTOREFRESH === 'true') {
215
+ return true;
216
+ }
217
+ return false;
218
+ }
219
+ function unknownSkillMessage(name) {
220
+ const available = skills_1.SKILL_CATALOG.map((s) => s.name).join(', ');
221
+ return `Unknown skill "${name}". Available: ${available}`;
222
+ }
223
+ //# sourceMappingURL=skill.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/services/skill.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import { CLI_VERSION } from '../lib/cli-version';
2
+ export { CLI_VERSION };
3
+ /**
4
+ * Catalog of Brevo-authored agent skills installable via `brevo skill:cli install`.
5
+ *
6
+ * Source content lives under `agent-context/` at the repo root — the same
7
+ * directory the README documents for manual install (`cp .../agent-context/
8
+ * SKILL.md ...`). Keeping a single source avoids drift between the
9
+ * programmatic install path and the documented manual path.
10
+ *
11
+ * **Skill version is the CLI version.** Every published CLI release carries
12
+ * its own bundled `agent-context/`, so installed skills auto-refresh after a
13
+ * CLI upgrade even if `SKILL.md` itself didn't change. This eliminates the
14
+ * "forgot to bump skill version when editing SKILL.md" failure mode.
15
+ *
16
+ * To add a new skill:
17
+ * 1. Drop SKILL.md (+ any supporting files) under `agent-context/<subdir>/`,
18
+ * or directly under `agent-context/` if it shares the brevo-cli layout.
19
+ * 2. Add an entry below with `subdir` pointing at the right directory.
20
+ */
21
+ export interface SkillEntry {
22
+ /** Stable, kebab-case identifier for the skill catalog entry. */
23
+ name: string;
24
+ /** Short one-line summary. */
25
+ description: string;
26
+ /** Tracks the CLI version (see `CLI_VERSION` below). */
27
+ version: string;
28
+ /**
29
+ * Subdirectory under `SKILLS_BUNDLE_DIR` that holds this skill's files.
30
+ * `''` means files live directly in the bundle root (used by brevo-cli,
31
+ * which shares `agent-context/` with the manually-installable copy).
32
+ */
33
+ subdir: string;
34
+ /** Files to copy, relative to `SKILLS_BUNDLE_DIR/<subdir>/`. */
35
+ files: string[];
36
+ }
37
+ export declare const SKILL_CATALOG: readonly SkillEntry[];
38
+ /**
39
+ * Absolute path to the bundled skill source directory. Resolved relative to
40
+ * this file so the same code works under ts-jest (`src/skills/`), built dev
41
+ * builds (`dist/skills/`), and the published tarball
42
+ * (`node_modules/@getbrevo/cli/dist/skills/`). The `agent-context/` directory
43
+ * is shipped at the package root via `package.json` `files:`.
44
+ */
45
+ export declare const SKILLS_BUNDLE_DIR: string;
46
+ export declare function getSkill(name: string): SkillEntry | undefined;
47
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EASrC,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAuD,CAAC;AAEtF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D"}
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.SKILLS_BUNDLE_DIR = exports.SKILL_CATALOG = exports.CLI_VERSION = void 0;
37
+ exports.getSkill = getSkill;
38
+ const path = __importStar(require("node:path"));
39
+ const cli_version_1 = require("../lib/cli-version");
40
+ Object.defineProperty(exports, "CLI_VERSION", { enumerable: true, get: function () { return cli_version_1.CLI_VERSION; } });
41
+ exports.SKILL_CATALOG = [
42
+ {
43
+ name: 'brevo-cli',
44
+ description: 'Agent primer for the Brevo Developer CLI — decision tree, hard rules, and command map for the `brevo` binary.',
45
+ version: cli_version_1.CLI_VERSION,
46
+ subdir: '',
47
+ files: ['SKILL.md'],
48
+ },
49
+ ];
50
+ /**
51
+ * Absolute path to the bundled skill source directory. Resolved relative to
52
+ * this file so the same code works under ts-jest (`src/skills/`), built dev
53
+ * builds (`dist/skills/`), and the published tarball
54
+ * (`node_modules/@getbrevo/cli/dist/skills/`). The `agent-context/` directory
55
+ * is shipped at the package root via `package.json` `files:`.
56
+ */
57
+ exports.SKILLS_BUNDLE_DIR = path.resolve(__dirname, '..', '..', 'agent-context');
58
+ function getSkill(name) {
59
+ return exports.SKILL_CATALOG.find((s) => s.name === name);
60
+ }
61
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,4BAEC;AA/DD,gDAAkC;AAElC,oDAAiD;AACxC,4FADA,yBAAW,OACA;AAsCP,QAAA,aAAa,GAA0B;IAClD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,+GAA+G;QACjH,OAAO,EAAE,yBAAW;QACpB,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,CAAC,UAAU,CAAC;KACpB;CACO,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AAEtF,SAAgB,QAAQ,CAAC,IAAY;IACnC,OAAO,qBAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC"}
@@ -10,7 +10,7 @@ Implements the authorization code flow to obtain access tokens for the Brevo API
10
10
  ## Project structure
11
11
  ```
12
12
  .
13
- ├── app-config.json App metadata (app ID, redirect URIs, scopes)
13
+ ├── app-config.json App metadata (app ID, redirect URIs, scopes, logo URL)
14
14
  ├── .gitignore Ignores .env.local and build artifacts
15
15
  ├── AGENTS.md AI agent guidance (this file)
16
16
  ├── CLAUDE.md Claude Code guidance
@@ -45,3 +45,8 @@ yarn --cwd src/oauth install
45
45
  # or: npm --prefix src/oauth install
46
46
  brevo app start oauth # port is read from app-config.json; override with --port
47
47
  ```
48
+
49
+ ## Docs
50
+ - [Brevo API Documentation](https://developers.brevo.com)
51
+ - [Brevo CLI reference](https://developers.brevo.com/docs/cli-reference) — full command and option list
52
+ - [Brevo CLI repo](https://github.com/getbrevo/brevo-cli)
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## Project
4
4
  Brevo OAuth integration for app `{{APP_ID}}`.
5
- Scaffolded with the [Brevo CLI](https://github.com/getbrevo/brevo-cli).
5
+ Scaffolded with the [Brevo CLI](https://github.com/getbrevo/brevo-cli) — see the [Brevo CLI reference](https://developers.brevo.com/docs/cli-reference) for the full command list.
6
6
 
7
7
  > **This is a test app** scaffolded by the Brevo CLI to help you test your OAuth integration locally.
8
8
 
@@ -16,7 +16,7 @@ brevo app start oauth # port is read from app-config.json; override with
16
16
  ## Structure
17
17
  ```
18
18
  .
19
- ├── app-config.json App metadata (ID, scopes, redirect URLs)
19
+ ├── app-config.json App metadata (ID, scopes, redirect URLs, logo URL)
20
20
  ├── .gitignore Ignores .env.local and build artifacts
21
21
  ├── AGENTS.md AI agent guidance
22
22
  ├── CLAUDE.md Claude Code guidance (this file)
@@ -26,7 +26,7 @@ Brevo OAuth integration for testing and implementing app authorization flows, sc
26
26
 
27
27
  ```
28
28
  .
29
- ├── app-config.json App config — ID, scopes, redirect URLs
29
+ ├── app-config.json App config — ID, scopes, redirect URLs, logo URL
30
30
  ├── .gitignore Ignores .env.local and build artifacts
31
31
  ├── AGENTS.md AI agent guidance
32
32
  ├── CLAUDE.md Claude Code guidance
@@ -61,6 +61,7 @@ Push changes to Brevo directly from the CLI:
61
61
  brevo app update --name "New Name"
62
62
  brevo app update --redirect-url https://myapp.com/callback
63
63
  brevo app update --name "New Name" --redirect-url https://myapp.com/callback
64
+ brevo app update --logo-uri https://example.com/logo.png
64
65
  ```
65
66
 
66
67
  `--redirect-url` is repeatable and **appends** to existing URLs.
@@ -80,4 +81,5 @@ brevo app update --app-id {{APP_ID}} --name "New Name"
80
81
  ## Docs
81
82
 
82
83
  - [Brevo API Documentation](https://developers.brevo.com)
84
+ - [Brevo CLI reference](https://developers.brevo.com/docs/cli-reference)
83
85
  - [Brevo CLI](https://github.com/getbrevo/brevo-cli)
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "appId": "{{APP_ID}}",
3
3
  "appName": "{{APP_NAME}}",
4
+ "logoUri": "{{LOGO_URI}}",
4
5
  "cliVersion": "{{CLI_VERSION}}",
5
- "minCliVersion": "{{MIN_CLI_VERSION}}",
6
6
  "auth": {
7
7
  "type": "private",
8
8
  "scopes": {{SCOPES_JSON}},
@@ -36,8 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
36
36
  exports.readmeTemplate = exports.claudeMdTemplate = exports.agentsMdTemplate = exports.appConfigTemplate = exports.packageJsonTemplate = exports.gitignoreTemplate = exports.envLocalTemplate = exports.envExampleTemplate = exports.tokenStoreJsTemplate = exports.oauthHandlerTemplate = exports.oauthServerJsTemplate = exports.TEMPLATE_MANIFEST = void 0;
37
37
  exports.applyVars = applyVars;
38
38
  exports.loadAllTemplates = loadAllTemplates;
39
- const fs = __importStar(require("fs"));
40
- const path = __importStar(require("path"));
39
+ const fs = __importStar(require("node:fs"));
40
+ const path = __importStar(require("node:path"));
41
41
  const TEMPLATES_DIR = path.resolve(__dirname, 'files');
42
42
  /**
43
43
  * Read a .tmpl file from the templates/files directory.
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -14,6 +14,7 @@ export interface OAuthApp {
14
14
  public?: boolean;
15
15
  redirect_uris: string[];
16
16
  scopes?: string[];
17
+ logo_uri?: string;
17
18
  created_at: string;
18
19
  updated_at: string;
19
20
  }
@@ -24,6 +25,7 @@ export interface CreateAppResponse {
24
25
  client_secret: string;
25
26
  public?: boolean;
26
27
  redirect_uris: string[];
28
+ logo_uri?: string;
27
29
  created_at: string;
28
30
  updated_at: string;
29
31
  }
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}