@synoikia/create-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 via-justa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @synoikia/create-plugin
+
+Create [Synoikia](https://github.com/via-justa/synoikia-core) plugin repositories and plugins, then build, check and publish them. Guide: [`docs/plugin-authoring.md`](https://github.com/via-justa/synoikia-core/blob/main/docs/plugin-authoring.md).
+
+```sh
+pnpm create @synoikia/plugin my-plugins [--repository owner/name] [--release] [--claude]
+```
+
+Inside a plugin repository (a root devDependency; `pnpm new` maps to `synoikia-plugin new`):
+
+| Command                                             | What                                                                      |
+| --------------------------------------------------- | ------------------------------------------------------------------------- |
+| `synoikia-plugin new`                               | Add a plugin: `--id --name --archetype --auth [--api-key-header] --yes`   |
+| `synoikia-plugin build [dir]`                       | Bundle a plugin into `dist/index.js`, `plugin.yaml` validated and inlined |
+| `synoikia-plugin check [dir…]`                      | Manifest, `plugin.yaml` and version checks                                |
+| `synoikia-plugin repo pack\|index\|verify\|publish` | The signed plugin repository steps a release workflow runs                |
+
+`@synoikia/create-plugin/vitest` exports `pluginFiles()`, the Vitest plugin that loads `.yaml` and `.md` imports as the bundle does.
+
+Templates are plain files with `{{name}}` placeholders; nothing in a template runs. A smoke test scaffolds every archetype and runs its generated tests against the workspace SDK and core.

package/dist/build.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bundles a plugin into one self-contained `dist/index.js`: under the permission model the child can
+ * read nothing outside its own package directory, so every dependency is inlined, and data files
+ * (`plugin.yaml`, guides) are compiled in. The banner gives the ESM bundle a `require` for bundled
+ * CommonJS (such as `ws`).
+ */
+export interface BuildOptions {
+    /** The plugin package directory. */
+    dir: string;
+    entry?: string;
+    outfile?: string;
+    /** Extra export conditions, e.g. `synoikia-source` to bundle workspace sources in tests. */
+    conditions?: string[];
+    minify?: boolean;
+}
+export declare function buildPlugin(opts: BuildOptions): Promise<string>;

package/dist/build.js

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { build } from 'esbuild';
+import { moduleSource } from './files.js';
+const BANNER = "import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);";
+const dataFiles = {
+    name: 'synoikia-plugin-files',
+    setup(b) {
+        b.onLoad({ filter: /\.(ya?ml|md)$/ }, (args) => ({
+            contents: moduleSource(args.path),
+            loader: 'js',
+            watchFiles: [args.path],
+        }));
+    },
+};
+export async function buildPlugin(opts) {
+    const outfile = path.resolve(opts.dir, opts.outfile ?? 'dist/index.js');
+    await build({
+        entryPoints: [path.resolve(opts.dir, opts.entry ?? 'src/index.ts')],
+        outfile,
+        bundle: true,
+        platform: 'node',
+        format: 'esm',
+        target: 'node22',
+        logLevel: 'warning',
+        banner: { js: BANNER },
+        conditions: opts.conditions,
+        minify: opts.minify ?? false,
+        plugins: [dataFiles],
+    });
+    return outfile;
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB1C,MAAM,MAAM,GACV,mHAAmH,CAAC;AAEtH,MAAM,SAAS,GAAW;IACxB,IAAI,EAAE,uBAAuB;IAC7B,KAAK,CAAC,CAAC;QACL,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IACxE,MAAM,KAAK,CAAC;QACV,WAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC;QACnE,OAAO;QACP,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACtB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/check.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Static checks of a plugin package, the ones every plugin used to repeat in a `manifest.test.ts`:
+ * the manifest is valid and compatible with this SDK, credential fields are write-only secrets in
+ * `sensitiveKeys`, `plugin.yaml` is valid and names only declared match profiles, the manifest id is
+ * the directory name, and `manifest.json` and `package.json` carry the same version.
+ */
+export declare function checkPlugin(dir: string): string[];

package/dist/check.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { checkManifest, isSdkCompatible, parseManifest, parsePluginSettings } from '@synoikia/plugin-sdk';
+import { parseYamlFile } from './files.js';
+/**
+ * Static checks of a plugin package, the ones every plugin used to repeat in a `manifest.test.ts`:
+ * the manifest is valid and compatible with this SDK, credential fields are write-only secrets in
+ * `sensitiveKeys`, `plugin.yaml` is valid and names only declared match profiles, the manifest id is
+ * the directory name, and `manifest.json` and `package.json` carry the same version.
+ */
+export function checkPlugin(dir) {
+    const read = (name) => JSON.parse(readFileSync(path.join(dir, name), 'utf8'));
+    let manifest;
+    try {
+        manifest = read('manifest.json');
+    }
+    catch (err) {
+        return [`manifest.json: ${err.message}`];
+    }
+    const issues = [];
+    let settings;
+    const yamlFile = path.join(dir, 'plugin.yaml');
+    if (existsSync(yamlFile)) {
+        try {
+            settings = parsePluginSettings(parseYamlFile(yamlFile));
+        }
+        catch (err) {
+            issues.push(`plugin.yaml: ${err.message}`);
+        }
+    }
+    issues.push(...checkManifest(manifest, settings));
+    if (issues.some((i) => i.startsWith('manifest:')))
+        return issues;
+    const parsed = parseManifest(manifest);
+    if (!isSdkCompatible(parsed))
+        issues.push(`manifest.json: sdk ${parsed.sdk} does not accept this SDK`);
+    if (parsed.id !== path.basename(path.resolve(dir)))
+        issues.push(`manifest.json: id ${parsed.id} is not the directory name ${path.basename(path.resolve(dir))}`);
+    try {
+        const pkg = read('package.json');
+        if (pkg.version !== parsed.version)
+            issues.push(`package.json version ${String(pkg.version)} and manifest.json version ${parsed.version} differ`);
+    }
+    catch (err) {
+        issues.push(`package.json: ${err.message}`);
+    }
+    return issues;
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE1G,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;IACjH,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,kBAAmB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,QAA6C,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACjE,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,GAAG,2BAA2B,CAAC,CAAC;IACvG,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,EAAE,8BAA8B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9G,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;YAChC,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,8BAA8B,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC;IAClH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,iBAAkB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { buildPlugin } from './build.js';
+import { checkPlugin } from './check.js';
+import { askPluginOptions, PLUGIN_FLAGS, prompts } from './prompts.js';
+import { createRepoTool } from './repo.js';
+import { findRepoRoot } from './repo-root.js';
+import { install, newPlugin } from './scaffold.js';
+const USAGE = `synoikia-plugin <command>
+
+  new                       Add a plugin to this repository (asks for what flags don't give)
+      --id <id> --name <name> --namespace <ns> --description <text>
+      --archetype openapi-rest|static-rest|websocket-rpc|blank
+      --auth bearer|api-key|basic|none [--api-key-header X-Api-Key]
+      --yes (no prompts) --skip-install
+  build [dir]               Bundle a plugin into dist/index.js (plugin.yaml and guides inlined)
+      --conditions a,b      Extra export conditions
+  check [dir...]            Check manifests, plugin.yaml and versions (default: this plugin, or all)
+  repo pack|index|verify|publish
+                            Build the signed plugin repository (release workflow steps)
+      --repository owner/name --out .repo --current .repo-current/index.json
+`;
+async function main(argv) {
+    const [command, ...rest] = argv;
+    switch (command) {
+        case 'new': {
+            const { values } = parseArgs({ args: rest, options: PLUGIN_FLAGS });
+            const root = findRepoRoot();
+            const opts = await askPluginOptions(root, values);
+            const files = newPlugin(opts);
+            prompts.log.success(`Created plugins/${opts.id} (${files.length} files)`);
+            if (!values['skip-install'])
+                install(root);
+            prompts.outro(`Next: describe ${opts.name}'s operations in plugins/${opts.id}/plugin.yaml, then run pnpm --filter ./plugins/${opts.id} test`);
+            return 0;
+        }
+        case 'build': {
+            const { values, positionals } = parseArgs({
+                args: rest,
+                allowPositionals: true,
+                options: { conditions: { type: 'string' } },
+            });
+            const dir = path.resolve(positionals[0] ?? '.');
+            await buildPlugin({ dir, conditions: values.conditions?.split(',').filter(Boolean) });
+            return 0;
+        }
+        case 'check': {
+            const { positionals } = parseArgs({ args: rest, allowPositionals: true, options: {} });
+            let dirs = positionals.map((d) => path.resolve(d));
+            if (!dirs.length) {
+                if (existsSync('manifest.json'))
+                    dirs = [process.cwd()];
+                else {
+                    const plugins = path.join(findRepoRoot(), 'plugins');
+                    dirs = readdirSync(plugins)
+                        .map((d) => path.join(plugins, d))
+                        .filter((d) => existsSync(path.join(d, 'manifest.json')));
+                }
+            }
+            let failed = false;
+            for (const dir of dirs) {
+                const issues = checkPlugin(dir);
+                for (const issue of issues)
+                    console.error(`${path.basename(dir)}: ${issue}`);
+                failed ||= issues.length > 0;
+            }
+            if (!failed)
+                console.log(`checked ${dirs.length} plugin(s)`);
+            return failed ? 1 : 0;
+        }
+        case 'repo': {
+            const { values, positionals } = parseArgs({
+                args: rest,
+                allowPositionals: true,
+                options: { repository: { type: 'string' }, out: { type: 'string' }, current: { type: 'string' } },
+            });
+            const tool = createRepoTool({ root: findRepoRoot(), ...values });
+            const step = positionals[0];
+            if (step === 'pack')
+                tool.pack();
+            else if (step === 'index')
+                tool.index();
+            else if (step === 'verify')
+                await tool.verify();
+            else if (step === 'publish')
+                tool.publish();
+            else {
+                console.error(USAGE);
+                return 2;
+            }
+            return 0;
+        }
+        default:
+            console.error(USAGE);
+            return command === undefined || command === '--help' || command === 'help' ? 0 : 2;
+    }
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/create.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/create.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { askPluginOptions, PLUGIN_FLAGS, prompts } from './prompts.js';
+import { createRepo, install, newPlugin } from './scaffold.js';
+/**
+ * `pnpm create @synoikia/plugin <dir>`: a new plugin repository, then its first plugin.
+ */
+const USAGE = `create-plugin <dir> [--repository owner/name] [--release] [--claude] [--no-plugin]
+                   [plugin flags, see: synoikia-plugin new]`;
+async function main(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            ...PLUGIN_FLAGS,
+            repository: { type: 'string' },
+            release: { type: 'boolean' },
+            claude: { type: 'boolean' },
+            'no-plugin': { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    if (values.help || positionals.length !== 1) {
+        console.error(USAGE);
+        return values.help ? 0 : 2;
+    }
+    const dir = path.resolve(positionals[0]);
+    prompts.intro(`Creating a Synoikia plugin repository in ${dir}`);
+    const ask = !values.yes && process.stdin.isTTY === true;
+    const release = values.release ??
+        (ask
+            ? await prompts.confirm({ message: 'Add the signed-release workflow (publishes a plugin repository)?' })
+            : false);
+    const claude = values.claude ??
+        (ask
+            ? await prompts.confirm({ message: 'Add the Claude Code setup (CLAUDE.md, skills, security reviewer)?' })
+            : false);
+    if (prompts.isCancel(release) || prompts.isCancel(claude))
+        return 1;
+    createRepo({ dir, repository: values.repository, release, claude });
+    if (!values['no-plugin']) {
+        const opts = await askPluginOptions(dir, values);
+        newPlugin(opts);
+        prompts.log.success(`Created plugins/${opts.id}`);
+    }
+    if (!values['skip-install'])
+        install(dir);
+    prompts.outro(`Done. cd ${path.relative(process.cwd(), dir) || '.'} && pnpm test`);
+    return 0;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"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"}

package/dist/files.d.ts

@@ -0,0 +1,12 @@
+/**
+ * How a plugin's data files become part of its bundle: `plugin.yaml` (and any other `.yaml`) is
+ * parsed at build time and inlined as JSON, and `.md` files are inlined as text. Nothing is read
+ * from disk at runtime, where the permission model would refuse it anyway. `plugin.yaml` is also
+ * validated against the SDK schema, so a malformed one fails the build, not the install.
+ */
+/** Parses YAML as plain data: no custom tags, and aliases capped against expansion bombs. */
+export declare function parseYamlFile(file: string): unknown;
+/** Parses a YAML file; a file named `plugin.yaml` must also be valid plugin settings. */
+export declare function loadYamlModule(file: string): unknown;
+/** The ES module source a data file compiles to. */
+export declare function moduleSource(file: string, contents?: string): string | undefined;

package/dist/files.js

@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parsePluginSettings } from '@synoikia/plugin-sdk';
+import { parse } from 'yaml';
+/**
+ * How a plugin's data files become part of its bundle: `plugin.yaml` (and any other `.yaml`) is
+ * parsed at build time and inlined as JSON, and `.md` files are inlined as text. Nothing is read
+ * from disk at runtime, where the permission model would refuse it anyway. `plugin.yaml` is also
+ * validated against the SDK schema, so a malformed one fails the build, not the install.
+ */
+/** Parses YAML as plain data: no custom tags, and aliases capped against expansion bombs. */
+export function parseYamlFile(file) {
+    const text = readFileSync(file, 'utf8');
+    try {
+        return parse(text, { maxAliasCount: 100 }) ?? {};
+    }
+    catch (err) {
+        throw new Error(`${file}: ${err.message}`, { cause: err });
+    }
+}
+/** Parses a YAML file; a file named `plugin.yaml` must also be valid plugin settings. */
+export function loadYamlModule(file) {
+    const data = parseYamlFile(file);
+    if (path.basename(file) === 'plugin.yaml') {
+        try {
+            parsePluginSettings(data);
+        }
+        catch (err) {
+            throw new Error(`${file} is not valid plugin settings:\n${err.message}`, { cause: err });
+        }
+    }
+    return data;
+}
+/** The ES module source a data file compiles to. */
+export function moduleSource(file, contents) {
+    if (/\.ya?ml$/.test(file))
+        return `export default ${JSON.stringify(loadYamlModule(file))};\n`;
+    if (file.endsWith('.md'))
+        return `export default ${JSON.stringify(contents ?? readFileSync(file, 'utf8'))};\n`;
+    return undefined;
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B;;;;;GAKG;AAEH,6FAA6F;AAC7F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mCAAoC,GAAa,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAiB;IAC1D,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IAC9F,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC;IAC/G,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { buildPlugin } from './build.js';
+export type { BuildOptions } from './build.js';
+export { checkPlugin } from './check.js';
+export { loadYamlModule, moduleSource, parseYamlFile } from './files.js';
+export { createRepoTool, repositoryFromRemote } from './repo.js';
+export type { RepoOptions } from './repo.js';
+export { findRepoRoot } from './repo-root.js';
+export { ARCHETYPES, AUTH_KINDS, createRepo, fill, manifestFor, newPlugin, renderTemplate, validateId, validateNamespace, } from './scaffold.js';
+export type { Archetype, AuthKind, CreateRepoOptions, NewPluginOptions } from './scaffold.js';
+export { pluginFiles } from './vitest.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export { buildPlugin } from './build.js';
+export { checkPlugin } from './check.js';
+export { loadYamlModule, moduleSource, parseYamlFile } from './files.js';
+export { createRepoTool, repositoryFromRemote } from './repo.js';
+export { findRepoRoot } from './repo-root.js';
+export { ARCHETYPES, AUTH_KINDS, createRepo, fill, manifestFor, newPlugin, renderTemplate, validateId, validateNamespace, } from './scaffold.js';
+export { pluginFiles } from './vitest.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,46 @@
+import * as p from '@clack/prompts';
+import type { NewPluginOptions } from './scaffold.js';
+/** Flags shared by `create-plugin` and `synoikia-plugin new`. */
+export declare const PLUGIN_FLAGS: {
+    readonly id: {
+        readonly type: "string";
+    };
+    readonly name: {
+        readonly type: "string";
+    };
+    readonly namespace: {
+        readonly type: "string";
+    };
+    readonly description: {
+        readonly type: "string";
+    };
+    readonly archetype: {
+        readonly type: "string";
+    };
+    readonly auth: {
+        readonly type: "string";
+    };
+    readonly 'api-key-header': {
+        readonly type: "string";
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly short: "y";
+    };
+    readonly 'skip-install': {
+        readonly type: "boolean";
+    };
+};
+export interface PluginFlags {
+    id?: string;
+    name?: string;
+    namespace?: string;
+    description?: string;
+    archetype?: string;
+    auth?: string;
+    'api-key-header'?: string;
+    yes?: boolean;
+}
+/** Fills in plugin options from flags, asking for what's missing when run in a terminal. */
+export declare function askPluginOptions(root: string, flags: PluginFlags): Promise<NewPluginOptions>;
+export { p as prompts };

package/dist/prompts.js

@@ -0,0 +1,112 @@
+import * as p from '@clack/prompts';
+import { ARCHETYPES, AUTH_KINDS, camelCase, validateDescription, validateId, validateName, validateNamespace, } from './scaffold.js';
+/** Flags shared by `create-plugin` and `synoikia-plugin new`. */
+export const PLUGIN_FLAGS = {
+    id: { type: 'string' },
+    name: { type: 'string' },
+    namespace: { type: 'string' },
+    description: { type: 'string' },
+    archetype: { type: 'string' },
+    auth: { type: 'string' },
+    'api-key-header': { type: 'string' },
+    yes: { type: 'boolean', short: 'y' },
+    'skip-install': { type: 'boolean' },
+};
+const interactive = (flags) => !flags.yes && process.stdin.isTTY === true;
+function done(value) {
+    if (typeof value === 'symbol') {
+        p.cancel('Cancelled');
+        process.exit(1);
+    }
+    return value;
+}
+const titleCase = (id) => id
+    .split('-')
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(' ');
+/** Fills in plugin options from flags, asking for what's missing when run in a terminal. */
+export async function askPluginOptions(root, flags) {
+    const ask = interactive(flags);
+    const need = (what) => {
+        throw new Error(`--${what} is required when not running interactively`);
+    };
+    const check = (problem) => {
+        if (problem)
+            throw new Error(problem);
+    };
+    let id = flags.id;
+    if (id === undefined) {
+        if (!ask)
+            need('id');
+        id = done(await p.text({
+            message: 'Plugin id (lowercase, the directory name)',
+            placeholder: 'acme',
+            validate: (v) => validateId(v ?? '', root),
+        }));
+    }
+    check(validateId(id, root));
+    let name = flags.name;
+    if (name === undefined) {
+        name = ask
+            ? done(await p.text({
+                message: 'Display name',
+                initialValue: titleCase(id),
+                validate: (v) => (v ? undefined : 'Required'),
+            }))
+            : titleCase(id);
+    }
+    check(validateName(name));
+    if (flags.description !== undefined)
+        check(validateDescription(flags.description));
+    let namespace = flags.namespace;
+    if (namespace === undefined) {
+        namespace = ask
+            ? done(await p.text({
+                message: 'Sandbox namespace (what code calls: <namespace>.call(...))',
+                initialValue: camelCase(id),
+                validate: (v) => validateNamespace(v ?? ''),
+            }))
+            : camelCase(id);
+    }
+    const nsProblem = validateNamespace(namespace);
+    if (nsProblem)
+        throw new Error(`Namespace "${namespace}": ${nsProblem} (pass --namespace)`);
+    let archetype = flags.archetype;
+    if (archetype === undefined) {
+        if (!ask)
+            need('archetype');
+        archetype = done(await p.select({
+            message: 'What kind of upstream API?',
+            options: Object.entries(ARCHETYPES).map(([value, hint]) => ({ value: value, label: value, hint })),
+        }));
+    }
+    if (!(archetype in ARCHETYPES))
+        throw new Error(`--archetype must be one of ${Object.keys(ARCHETYPES).join(', ')}`);
+    let auth = flags.auth;
+    if (auth === undefined) {
+        if (!ask)
+            need('auth');
+        auth = done(await p.select({
+            message: 'How does it authenticate?',
+            options: Object.entries(AUTH_KINDS).map(([value, hint]) => ({ value: value, label: value, hint })),
+        }));
+    }
+    if (!(auth in AUTH_KINDS))
+        throw new Error(`--auth must be one of ${Object.keys(AUTH_KINDS).join(', ')}`);
+    let apiKeyHeader = flags['api-key-header'];
+    if (auth === 'api-key' && apiKeyHeader === undefined && ask) {
+        apiKeyHeader = done(await p.text({ message: 'API key header', initialValue: 'X-Api-Key' }));
+    }
+    return {
+        root,
+        id: id,
+        name: name,
+        namespace: namespace,
+        ...(flags.description ? { description: flags.description } : {}),
+        archetype: archetype,
+        auth: auth,
+        ...(apiKeyHeader ? { apiKeyHeader } : {}),
+    };
+}
+export { p as prompts };
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/repo-root.d.ts

@@ -0,0 +1,10 @@
+/** The plugin repository root: the nearest directory up from `start` with a `pnpm-workspace.yaml`. */
+export declare function findRepoRoot(start?: string): string;
+/** This package's directory. */
+export declare const PACKAGE_DIR: string;
+export declare const TEMPLATES_DIR: string;
+/**
+ * The range generated packages should use for one of this tool's own dependencies: as published
+ * (`pnpm pack` turns `workspace:` ranges into real ones), else from the installed version.
+ */
+export declare function dependencyRange(name: string): string;