@cmdless/core 0.0.0 → 0.0.1

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 cmdless
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
@@ -0,0 +1,3 @@
1
+ export * from './utils.js';
2
+ export * from './packages.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ export * from './utils.js';
2
+ export * from './packages.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
@@ -0,0 +1,49 @@
1
+ export declare function getInstallPath(cmdlessRoot: string): string;
2
+ export declare function getLatestPackageVersion(packageName: string): Promise<string>;
3
+ export declare function getPackageName(specifier: string): {
4
+ packageName: string;
5
+ packageVersion?: undefined;
6
+ } | {
7
+ packageName: string;
8
+ packageVersion: string;
9
+ };
10
+ export declare function getPrefix(parameters: PackageInstallParams): Promise<{
11
+ packageName: string;
12
+ version: string;
13
+ prefix: string;
14
+ cmdlessRoot: string;
15
+ }>;
16
+ export declare function getMetaPackageVersion(specifier: string, meta: ImportMeta): Promise<string>;
17
+ export declare function resolveBinFromPackageJson(packagePath: string): string | null;
18
+ export declare function findLocalBinPath(packageName: string, meta: ImportMeta): string | null;
19
+ export type PackageInstallParams = {
20
+ specifier: string;
21
+ version?: string;
22
+ cmdlessRoot?: string;
23
+ };
24
+ export declare function ensurePackage(parameters: PackageInstallParams): Promise<{
25
+ packageName: string;
26
+ prefix: string;
27
+ cmdlessRoot: string;
28
+ }>;
29
+ export declare function packageEnv(cmdlessRoot?: string): NodeJS.ProcessEnv;
30
+ export declare function forwardSignals(child: import('node:child_process').ChildProcess): void;
31
+ export declare function execProcess(command: string, args: string[], env: NodeJS.ProcessEnv, signal?: AbortSignal): Promise<string>;
32
+ export declare function runPackage(packageName: string, prefix: string, args?: string[], cmdlessRoot?: string, signal?: AbortSignal): Promise<string>;
33
+ export declare function spawnPackage(packageName: string, prefix: string, args?: string[], env?: NodeJS.ProcessEnv): import("child_process").ChildProcess;
34
+ export declare function runAsPackage(parameters: PackageInstallParams, args?: string[], signal?: AbortSignal): Promise<string>;
35
+ export declare function resolvePackageBin(meta: ImportMeta, packageName: string, version?: string, cmdlessRoot?: string): Promise<{
36
+ binPath: string;
37
+ env: NodeJS.ProcessEnv;
38
+ }>;
39
+ export type SpawnAsPackageOptions = {
40
+ version?: string;
41
+ cmdlessRoot?: string;
42
+ };
43
+ export declare function spawnAsPackage(meta: ImportMeta, packageName: string, args?: string[], options?: SpawnAsPackageOptions): Promise<import("child_process").ChildProcessByStdio<import("stream").Writable, import("stream").Readable, null>>;
44
+ export type PackageExportOptions = {
45
+ version?: string;
46
+ cmdlessRoot?: string;
47
+ };
48
+ export declare function resolvePackageExport(meta: ImportMeta, packageName: string, subpath: string, options?: PackageExportOptions): Promise<string>;
49
+ //# sourceMappingURL=packages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/node/packages.ts"],"names":[],"mappings":"AASA,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,UAEjD;AAGD,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,mBAGhE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;;;;EAc/C;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,oBAAoB;;;;;GAO/D;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,mBAM9E;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAIrF;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,aAAa,CAAC,UAAU,EAAE,oBAAoB;;;;GAKnE;AAED,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAIlE;AAaD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,oBAAoB,EAAE,YAAY,QAQ9E;AAOD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1H;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,mBAEpI;AAID,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,wCAE1H;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,oBAAoB,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,MAAM,CAAC,EAAE,WAAW,mBAG7G;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;GAQpH;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAOF,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,qBAA0B,oHAKnI;AAGD,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAKF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,mBAQpI"}
@@ -0,0 +1,160 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { findPackageJSON } from 'node:module';
4
+ import { execFileSync, spawn } from 'node:child_process';
5
+ import { getCmdlessRoot, setCmdlessRoot } from './utils.js';
6
+ // running npm packages from wherever they are: the local install when
7
+ // there is one, or else a version installed into the cmdless root
8
+ export function getInstallPath(cmdlessRoot) {
9
+ return path.join(cmdlessRoot, 'node', 'packages');
10
+ }
11
+ const decoder = new TextDecoder();
12
+ export async function getLatestPackageVersion(packageName) {
13
+ const stdout = execFileSync("npm", ["view", packageName, "version"]);
14
+ return decoder.decode(stdout).trim();
15
+ }
16
+ export function getPackageName(specifier) {
17
+ const lastAtIndex = specifier.lastIndexOf("@");
18
+ if (lastAtIndex > 0) {
19
+ const packageName = specifier.substring(0, lastAtIndex);
20
+ const packageVersion = specifier.substring(lastAtIndex + 1);
21
+ // "latest" is a moving target, not a real pinned version - treat it as
22
+ // if no version was given at all, so it resolves (and caches) for real.
23
+ if (packageVersion.toLowerCase() === 'latest')
24
+ return { packageName };
25
+ return { packageName, packageVersion };
26
+ }
27
+ return { packageName: specifier };
28
+ }
29
+ export async function getPrefix(parameters) {
30
+ const { packageName, packageVersion } = getPackageName(parameters.specifier);
31
+ const cmdlessRoot = parameters.cmdlessRoot ?? getCmdlessRoot();
32
+ const installPath = getInstallPath(cmdlessRoot);
33
+ const version = packageVersion ?? parameters.version ?? await getLatestPackageVersion(packageName);
34
+ const prefix = path.join(installPath, packageName, version);
35
+ return { packageName, version, prefix, cmdlessRoot };
36
+ }
37
+ export async function getMetaPackageVersion(specifier, meta) {
38
+ const packagePath = findPackageJSON(specifier, meta.url);
39
+ if (!packagePath)
40
+ throw new Error(`package.json for package ${specifier} not found at ${meta.url}`);
41
+ const pkg = JSON.parse(await fs.promises.readFile(packagePath, 'utf8'));
42
+ return pkg.version;
43
+ }
44
+ export function resolveBinFromPackageJson(packagePath) {
45
+ const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
46
+ const bin = typeof pkg.bin === 'string' ? pkg.bin : Object.values(pkg.bin ?? {})[0];
47
+ if (typeof bin !== 'string')
48
+ return null;
49
+ return path.join(path.dirname(packagePath), bin);
50
+ }
51
+ export function findLocalBinPath(packageName, meta) {
52
+ const packagePath = findPackageJSON(packageName, meta.url);
53
+ if (!packagePath)
54
+ return null;
55
+ return resolveBinFromPackageJson(packagePath);
56
+ }
57
+ export async function ensurePackage(parameters) {
58
+ const { packageName, version, prefix, cmdlessRoot } = await getPrefix(parameters);
59
+ if (!fs.existsSync(path.join(prefix, 'node_modules', packageName, 'package.json')))
60
+ execFileSync("npm", ["install", "--prefix", prefix, `${packageName}@${version}`]);
61
+ return { packageName, prefix, cmdlessRoot };
62
+ }
63
+ export function packageEnv(cmdlessRoot) {
64
+ const env = { ...process.env };
65
+ if (cmdlessRoot)
66
+ setCmdlessRoot(cmdlessRoot, env);
67
+ return env;
68
+ }
69
+ function execPackageArgs(packageName, prefix, args) {
70
+ return ["exec", "--prefix", prefix, `--package=${packageName}`, '--', ...args];
71
+ }
72
+ // forwards SIGINT/SIGTERM to `child` - without this, killing *this* process
73
+ // while `child` is a long-running interactive app (e.g. Electron) leaves it
74
+ // orphaned, since nothing ever tells it to close. Uses `.on`, not `.once`:
75
+ // a real Ctrl+C delivers the signal to every process in the group at once,
76
+ // *and* each level explicitly re-forwards it to its own child - so a child
77
+ // two levels down gets hit twice, and a `.once` listener would revert to
78
+ // Node's default (immediate, ungraceful) termination on the second delivery.
79
+ export function forwardSignals(child) {
80
+ const forward = (signal) => child.kill(signal);
81
+ process.on('SIGINT', forward);
82
+ process.on('SIGTERM', forward);
83
+ child.once('exit', () => {
84
+ process.off('SIGINT', forward);
85
+ process.off('SIGTERM', forward);
86
+ });
87
+ }
88
+ // unlike execFileSync, this doesn't block the event loop for the process's
89
+ // whole lifetime - needed so forwardSignals (and anything else this process
90
+ // wants to do concurrently) can actually run while `command` is alive.
91
+ // runs a command to completion and resolves with its output. Aborting the
92
+ // signal stops it (SIGTERM) and rejects with the signal's reason.
93
+ export function execProcess(command, args, env, signal) {
94
+ return new Promise((resolve, reject) => {
95
+ if (signal?.aborted)
96
+ return reject(signal.reason);
97
+ const child = spawn(command, args, { env, stdio: ['inherit', 'pipe', 'inherit'] });
98
+ forwardSignals(child);
99
+ const abort = () => { child.kill('SIGTERM'); reject(signal.reason); };
100
+ signal?.addEventListener('abort', abort, { once: true });
101
+ child.once('exit', () => signal?.removeEventListener('abort', abort));
102
+ const chunks = [];
103
+ child.stdout?.on('data', (chunk) => chunks.push(chunk));
104
+ child.once('error', reject);
105
+ child.once('exit', code => {
106
+ if (code !== 0)
107
+ reject(new Error(`${command} exited with code ${code}`));
108
+ else
109
+ resolve(Buffer.concat(chunks).toString('utf8').trim());
110
+ });
111
+ });
112
+ }
113
+ export async function runPackage(packageName, prefix, args = [], cmdlessRoot, signal) {
114
+ return execProcess("npm", execPackageArgs(packageName, prefix, args), packageEnv(cmdlessRoot), signal);
115
+ }
116
+ // unlike runPackage, this is for a long-running process (e.g. an Electron
117
+ // app) - it hands back the live child instead of waiting on it to exit.
118
+ export function spawnPackage(packageName, prefix, args = [], env = process.env) {
119
+ return spawn("npm", execPackageArgs(packageName, prefix, args), { stdio: 'inherit', env });
120
+ }
121
+ export async function runAsPackage(parameters, args = [], signal) {
122
+ const { packageName, prefix, cmdlessRoot } = await ensurePackage(parameters);
123
+ return runPackage(packageName, prefix, args, cmdlessRoot, signal);
124
+ }
125
+ // resolves `packageName`'s bin locally first (via findLocalBinPath), falling
126
+ // back to ensurePackage's cache.
127
+ export async function resolvePackageBin(meta, packageName, version, cmdlessRoot) {
128
+ const localBinPath = findLocalBinPath(packageName, meta);
129
+ if (localBinPath)
130
+ return { binPath: localBinPath, env: packageEnv(cmdlessRoot) };
131
+ const { prefix, cmdlessRoot: root } = await ensurePackage({ specifier: packageName, version, cmdlessRoot });
132
+ const resolved = resolveBinFromPackageJson(path.join(prefix, 'node_modules', packageName, 'package.json'));
133
+ if (!resolved)
134
+ throw new Error(`package ${packageName} has no "bin" entry`);
135
+ return { binPath: resolved, env: packageEnv(root) };
136
+ }
137
+ // resolves packageName via resolvePackageBin, then spawns its bin directly
138
+ // with piped stdio, for a long-running process you need to stream to/from
139
+ // (e.g. an ACP agent's JSON-RPC-over-stdio) - unlike spawnPackage (stdio
140
+ // inherited from this process, e.g. Electron) or runPackage/runAsPackage
141
+ // (blocking, captures output only once the process exits).
142
+ export async function spawnAsPackage(meta, packageName, args = [], options = {}) {
143
+ const { binPath, env } = await resolvePackageBin(meta, packageName, options.version, options.cmdlessRoot);
144
+ const child = spawn(process.execPath, [binPath, ...args], { env, stdio: ['pipe', 'pipe', 'inherit'] });
145
+ forwardSignals(child);
146
+ return child;
147
+ }
148
+ // a file a package exports (say its './daemon'), as a path: from the local
149
+ // install when meta can see one, or else from `version` installed into the
150
+ // cmdless root
151
+ export async function resolvePackageExport(meta, packageName, subpath, options = {}) {
152
+ const packagePath = findPackageJSON(packageName, meta.url)
153
+ ?? path.join((await ensurePackage({ specifier: packageName, ...options })).prefix, 'node_modules', packageName, 'package.json');
154
+ const exported = JSON.parse(fs.readFileSync(packagePath, 'utf8')).exports?.[subpath];
155
+ const target = typeof exported === 'string' ? exported : exported?.import ?? exported?.default;
156
+ if (typeof target !== 'string')
157
+ throw new Error(`${packageName} doesn't export ${subpath}`);
158
+ return path.join(path.dirname(packagePath), target);
159
+ }
160
+ //# sourceMappingURL=packages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packages.js","sourceRoot":"","sources":["../../src/node/packages.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=packages.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packages.test.d.ts","sourceRoot":"","sources":["../../src/node/packages.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,36 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import { execProcess, getPackageName } from './packages.js';
4
+ test('execProcess resolves with what the command printed', async () => {
5
+ assert.equal(await execProcess(process.execPath, ['-e', 'console.log("hi")'], process.env), 'hi');
6
+ });
7
+ test('aborting execProcess stops the command and rejects with the reason', async () => {
8
+ const controller = new AbortController();
9
+ const started = Date.now();
10
+ const running = execProcess(process.execPath, ['-e', 'setTimeout(() => {}, 10_000)'], process.env, controller.signal);
11
+ setTimeout(() => controller.abort(new Error('closed')), 100);
12
+ await assert.rejects(running, /closed/);
13
+ assert.ok(Date.now() - started < 5_000);
14
+ });
15
+ test('getPackageName splits a scoped specifier with a version', () => {
16
+ assert.deepEqual(getPackageName('@cmdless/ui-runtime@0.0.3'), {
17
+ packageName: '@cmdless/ui-runtime',
18
+ packageVersion: '0.0.3',
19
+ });
20
+ });
21
+ test('getPackageName leaves an unversioned specifier alone', () => {
22
+ assert.deepEqual(getPackageName('@cmdless/ui-runtime'), {
23
+ packageName: '@cmdless/ui-runtime',
24
+ });
25
+ });
26
+ test('getPackageName treats an explicit "latest" the same as no version', () => {
27
+ assert.deepEqual(getPackageName('@cmdless/ui-runtime@latest'), {
28
+ packageName: '@cmdless/ui-runtime',
29
+ });
30
+ });
31
+ test('getPackageName treats "latest" case-insensitively', () => {
32
+ assert.deepEqual(getPackageName('@cmdless/ui-runtime@LATEST'), {
33
+ packageName: '@cmdless/ui-runtime',
34
+ });
35
+ });
36
+ //# sourceMappingURL=packages.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packages.test.js","sourceRoot":"","sources":["../../src/node/packages.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5D,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACpE,MAAM,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACpG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;IACpF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,8BAA8B,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACtH,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,2BAA2B,CAAC,EAAE;QAC5D,WAAW,EAAE,qBAAqB;QAClC,cAAc,EAAE,OAAO;KACxB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,qBAAqB,CAAC,EAAE;QACtD,WAAW,EAAE,qBAAqB;KACnC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,4BAA4B,CAAC,EAAE;QAC7D,WAAW,EAAE,qBAAqB;KACnC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,4BAA4B,CAAC,EAAE;QAC7D,WAAW,EAAE,qBAAqB;KACnC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=service.fixture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.fixture.d.ts","sourceRoot":"","sources":["../../src/node/service.fixture.ts"],"names":[],"mappings":""}
@@ -0,0 +1,15 @@
1
+ import { rejectService, resolveService } from './utils.js';
2
+ // a stand-in service for utils.test.ts: argv[2] picks how it reports back
3
+ const mode = process.argv[2];
4
+ if (mode === 'resolve') {
5
+ await resolveService({ pid: process.pid, args: process.argv.slice(3) });
6
+ // stay alive like a real service would, until the test kills it
7
+ setInterval(() => { }, 1 << 30);
8
+ }
9
+ else if (mode === 'reject') {
10
+ await rejectService(new Error('could not start'));
11
+ }
12
+ else if (mode === 'exit') {
13
+ process.exit(3);
14
+ }
15
+ //# sourceMappingURL=service.fixture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.fixture.js","sourceRoot":"","sources":["../../src/node/service.fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3D,0EAA0E;AAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;IACvB,MAAM,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,gEAAgE;IAChE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;KAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;IAC7B,MAAM,aAAa,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACpD,CAAC;KAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
@@ -0,0 +1,36 @@
1
+ import net from 'node:net';
2
+ import type { ChildProcess, SpawnOptions } from 'node:child_process';
3
+ export declare function getCmdlessRoot(): string;
4
+ export declare function setCmdlessRoot(root: string, env?: NodeJS.ProcessEnv): void;
5
+ export declare function getAppDataPath(app: string): string;
6
+ export declare function getTmpSocketPath(name: string): string;
7
+ export type ServiceMessage<T> = {
8
+ type: 'resolve';
9
+ value: T;
10
+ } | {
11
+ type: 'reject';
12
+ error: string;
13
+ };
14
+ export declare function sendTo<T>(socketPath: string, message: ServiceMessage<T>): Promise<void>;
15
+ export declare function listenOnce<T>(timeoutMs?: number): Promise<{
16
+ socketPath: string;
17
+ message: Promise<T>;
18
+ close: (reason?: unknown) => void;
19
+ }>;
20
+ export type WaitForServiceOptions = Omit<SpawnOptions, 'detached'> & {
21
+ timeoutMs?: number;
22
+ };
23
+ export declare function waitForService<T>(command: string, args?: string[], options?: WaitForServiceOptions): Promise<{
24
+ child: ChildProcess;
25
+ value: T;
26
+ }>;
27
+ export declare function resolveService<T>(value: T): Promise<void>;
28
+ export declare function rejectService(error: unknown): Promise<void>;
29
+ export declare function isPendingService(): boolean;
30
+ export declare function listenExclusive(server: net.Server, socketPath: string): Promise<boolean>;
31
+ export declare function nothingAnswers(error: unknown): boolean;
32
+ export type DaemonService = {
33
+ address: string;
34
+ };
35
+ export declare function connectOrStart<T>(connect: (address?: string) => Promise<T>, daemonPath: string): Promise<T>;
36
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/node/utils.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,UAAU,CAAC;AAK3B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMrE,wBAAgB,cAAc,WAE7B;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,QAGhF;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,UAEzC;AAOD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,UAQ5C;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAItC,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,iBAMvE;AAsBD,wBAAsB,UAAU,CAAC,CAAC,EAAE,SAAS,SAAS;;;qBAsBL,OAAO;GACvD;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG;IAEnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAQF,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,CA+B5C;AAcD,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,iBAEzC;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,iBAG3C;AAGD,wBAAgB,gBAAgB,YAE/B;AAuBD,wBAAsB,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB9F;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,WAG5C;AAGD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAKhD,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAUjH"}
@@ -0,0 +1,221 @@
1
+ import fs from 'node:fs';
2
+ import net from 'node:net';
3
+ import os from 'node:os';
4
+ import path from 'node:path';
5
+ import { spawn } from 'node:child_process';
6
+ import { createHash } from 'node:crypto';
7
+ const SERVICE_SOCKET_KEY = 'CMDLESS_SERVICE_SOCKET';
8
+ const ROOT_KEY = 'CMDLESS_ROOT';
9
+ // where everything cmdless keeps lives, unless CMDLESS_ROOT moves it
10
+ export function getCmdlessRoot() {
11
+ return process.env[ROOT_KEY] || path.join(os.homedir(), '.cmdless');
12
+ }
13
+ // moves the root for this process, or - given an env to spawn with - for a
14
+ // child; an empty root goes back to the default
15
+ export function setCmdlessRoot(root, env = process.env) {
16
+ if (root)
17
+ env[ROOT_KEY] = root;
18
+ else
19
+ delete env[ROOT_KEY];
20
+ }
21
+ // one app's own folder under the root, e.g. <root>/apps/hangar
22
+ export function getAppDataPath(app) {
23
+ return path.join(getCmdlessRoot(), 'apps', app);
24
+ }
25
+ // Unix socket paths are capped (104 bytes on macOS, 108 on Linux), and
26
+ // macOS's per-user tmpdir alone eats about half of that - a name that would
27
+ // push the path past it is swapped for a short hash of itself.
28
+ const MAX_SOCKET_PATH = 100;
29
+ export function getTmpSocketPath(name) {
30
+ if (process.platform === 'win32')
31
+ return path.join('\\\\.\\pipe', `${name}.sock`);
32
+ const socketPath = path.join(os.tmpdir(), `${name}.sock`);
33
+ if (Buffer.byteLength(socketPath) <= MAX_SOCKET_PATH)
34
+ return socketPath;
35
+ const hash = createHash('sha256').update(name).digest('base64url').slice(0, 16);
36
+ return path.join(os.tmpdir(), `${hash}.sock`);
37
+ }
38
+ // sends one newline-delimited JSON message to a socket listenOnce handed
39
+ // out, and waits for the other side to see it before tearing the socket down
40
+ export function sendTo(socketPath, message) {
41
+ return new Promise((resolve, reject) => {
42
+ const socket = net.createConnection(socketPath, () => socket.end(JSON.stringify(message) + '\n'));
43
+ socket.once('error', reject);
44
+ socket.once('close', () => resolve());
45
+ });
46
+ }
47
+ // reads the first newline-delimited JSON message off a socket.
48
+ function receiveOnce(socket) {
49
+ return new Promise((resolve, reject) => {
50
+ let buffer = '';
51
+ socket.setEncoding('utf8');
52
+ socket.on('data', chunk => {
53
+ buffer += chunk;
54
+ const pos = buffer.indexOf('\n');
55
+ if (pos === -1)
56
+ return;
57
+ try {
58
+ resolve(JSON.parse(buffer.slice(0, pos)));
59
+ }
60
+ catch (error) {
61
+ reject(error);
62
+ }
63
+ });
64
+ socket.once('error', reject);
65
+ });
66
+ }
67
+ // listens on a fresh temporary socket for one message: the first one
68
+ // settles it (a reject message rejects it), a sender that hangs up without
69
+ // sending rejects it, and so does the timeout (0 waits forever). The socket
70
+ // closes once it's settled. `socketPath` is what's handed to the sender.
71
+ export async function listenOnce(timeoutMs = 30_000) {
72
+ const socketPath = getTmpSocketPath(`cmdless-once-${crypto.randomUUID()}`);
73
+ let settle;
74
+ const message = new Promise((resolve, reject) => settle = { resolve, reject });
75
+ const server = net.createServer(socket => {
76
+ receiveOnce(socket).then(received => {
77
+ if (received.type === 'resolve')
78
+ settle.resolve(received.value);
79
+ else
80
+ settle.reject(new Error(received.error));
81
+ }, settle.reject);
82
+ socket.once('close', () => settle.reject(new Error('the sender hung up without sending')));
83
+ });
84
+ await listenOn(server, socketPath);
85
+ const timer = timeoutMs > 0
86
+ ? setTimeout(() => settle.reject(new Error(`nothing arrived within ${timeoutMs}ms`)), timeoutMs)
87
+ : undefined;
88
+ void message.catch(() => { }).finally(() => {
89
+ clearTimeout(timer);
90
+ server.close();
91
+ });
92
+ return { socketPath, message, close: (reason) => settle.reject(reason ?? new Error('stopped listening')) };
93
+ }
94
+ // spawns `command` detached and waits for it to call resolveService (or
95
+ // rejectService) - the spawned process decides on its own when it counts as
96
+ // started, and hands back whatever value it wants its caller to see (e.g.
97
+ // the address it listens on). The child is unref'd once it reports, so the
98
+ // caller can exit and leave it running. stdio defaults to 'ignore', since a
99
+ // detached service shouldn't keep writing into the caller's terminal.
100
+ export async function waitForService(command, args = [], options = {}) {
101
+ const { timeoutMs = 30_000, ...spawnOptions } = options;
102
+ const once = await listenOnce(timeoutMs);
103
+ const child = spawn(command, args, {
104
+ stdio: 'ignore',
105
+ windowsHide: true,
106
+ ...spawnOptions,
107
+ detached: true,
108
+ env: { ...(spawnOptions.env ?? process.env), [SERVICE_SOCKET_KEY]: once.socketPath },
109
+ });
110
+ const failed = new Promise((_, reject) => {
111
+ child.once('error', reject);
112
+ child.once('exit', (code, signal) => reject(new Error(`${command} exited (${signal ?? code}) before resolving as a service`)));
113
+ });
114
+ try {
115
+ const value = await Promise.race([once.message, failed]);
116
+ child.removeAllListeners('exit');
117
+ child.removeAllListeners('error');
118
+ child.unref();
119
+ return { child, value };
120
+ }
121
+ catch (error) {
122
+ once.close(error);
123
+ if (child.exitCode === null && child.signalCode === null)
124
+ child.kill();
125
+ throw error instanceof Error && error.message.startsWith('nothing arrived')
126
+ ? new Error(`${command} did not resolve as a service within ${timeoutMs}ms`)
127
+ : error;
128
+ }
129
+ }
130
+ function takeServiceSocket() {
131
+ const socketPath = process.env[SERVICE_SOCKET_KEY];
132
+ if (!socketPath)
133
+ throw new Error(`resolveService: no ${SERVICE_SOCKET_KEY} - was this process started by waitForService()?`);
134
+ // so nothing this process spawns later thinks it was started as a service
135
+ delete process.env[SERVICE_SOCKET_KEY];
136
+ return socketPath;
137
+ }
138
+ // the spawned side of waitForService: reports `value` back to whoever is
139
+ // waiting, completing the loop. Throws when this process wasn't started by
140
+ // waitForService.
141
+ export function resolveService(value) {
142
+ return sendTo(takeServiceSocket(), { type: 'resolve', value });
143
+ }
144
+ // reports a startup failure back to whoever is waiting, instead of leaving
145
+ // them to time out.
146
+ export function rejectService(error) {
147
+ const message = error instanceof Error ? error.message : String(error);
148
+ return sendTo(takeServiceSocket(), { type: 'reject', error: message });
149
+ }
150
+ // true when this process was started by waitForService and hasn't reported yet
151
+ export function isPendingService() {
152
+ return !!process.env[SERVICE_SOCKET_KEY];
153
+ }
154
+ function listenOn(server, socketPath) {
155
+ return new Promise((resolve, reject) => {
156
+ const onError = (error) => { server.off('listening', onListening); reject(error); };
157
+ const onListening = () => {
158
+ server.off('error', onError);
159
+ // only this user may connect - a named pipe on Windows keeps its
160
+ // default access, which this doesn't tighten
161
+ if (process.platform !== 'win32')
162
+ fs.chmodSync(socketPath, 0o600);
163
+ resolve();
164
+ };
165
+ server.once('error', onError);
166
+ server.once('listening', onListening);
167
+ server.listen(socketPath);
168
+ });
169
+ }
170
+ // listens on a named socket only if nothing else is - the socket is the
171
+ // lock, so a daemon that gets it is the only one. Resolves false when a live
172
+ // process already holds it. A Unix socket outlives a crashed process as a
173
+ // file nothing listens on, so a refused connection means it's stale and safe
174
+ // to replace; a named pipe on Windows goes away with its process.
175
+ export async function listenExclusive(server, socketPath) {
176
+ try {
177
+ await listenOn(server, socketPath);
178
+ return true;
179
+ }
180
+ catch (error) {
181
+ if (error.code !== 'EADDRINUSE')
182
+ throw error;
183
+ }
184
+ const live = await new Promise((resolve, reject) => {
185
+ const probe = net.createConnection(socketPath, () => { probe.end(); resolve(true); });
186
+ probe.once('error', error => {
187
+ if (error.code === 'ECONNREFUSED')
188
+ resolve(false);
189
+ else
190
+ reject(error);
191
+ });
192
+ });
193
+ if (live)
194
+ return false;
195
+ fs.rmSync(socketPath, { force: true });
196
+ await listenOn(server, socketPath);
197
+ return true;
198
+ }
199
+ // whether connecting failed because no daemon is there to answer - no
200
+ // socket, or a stale one nothing listens on
201
+ export function nothingAnswers(error) {
202
+ const code = error?.code;
203
+ return code === 'ENOENT' || code === 'ECONNREFUSED';
204
+ }
205
+ // connects to a running daemon, or starts it (from daemonPath) when nothing
206
+ // answers and connects to the address it resolves as a service. connect
207
+ // with no address tries the daemon's usual one.
208
+ export async function connectOrStart(connect, daemonPath) {
209
+ try {
210
+ return await connect();
211
+ }
212
+ catch (error) {
213
+ // only "nothing is there" starts one - anything else (a daemon that
214
+ // answered but won't do, say) is the caller's to see
215
+ if (!nothingAnswers(error))
216
+ throw error;
217
+ const { value } = await waitForService(process.execPath, [daemonPath]);
218
+ return connect(value.address);
219
+ }
220
+ }
221
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/node/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AACpD,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,qEAAqE;AACrE,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,2EAA2E;AAC3E,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC/E,IAAI,IAAI;QAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;;QAC1B,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,uEAAuE;AACvE,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,eAAe;QAAE,OAAO,UAAU,CAAC;IACxE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAChD,CAAC;AAMD,yEAAyE;AACzE,6EAA6E;AAC7E,MAAM,UAAU,MAAM,CAAI,UAAkB,EAAE,OAA0B;IACtE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAClG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,SAAS,WAAW,CAAI,MAAkB;IACxC,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC;YAChB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,OAAO;YACvB,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAClD,OAAO,KAAK,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qEAAqE;AACrE,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAI,SAAS,GAAG,MAAM;IACpD,MAAM,UAAU,GAAG,gBAAgB,CAAC,gBAAgB,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,MAA0E,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAElF,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;QACvC,WAAW,CAAI,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACrC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;;gBAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC;QAChG,CAAC,CAAC,SAAS,CAAC;IACd,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACzC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;AACvH,CAAC;AAOD,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,IAAI,GAAa,EAAE,EACnB,OAAO,GAA0B,EAAE;IAEnC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAI,SAAS,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QACjC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,IAAI;QACjB,GAAG,YAAY;QACf,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE;KACrF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAClC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,YAAY,MAAM,IAAI,IAAI,iCAAiC,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACvE,MAAM,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;YACzE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,wCAAwC,SAAS,IAAI,CAAC;YAC5E,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU;QACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,kBAAkB,kDAAkD,CAAC,CAAC;IAC9G,0EAA0E;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,yEAAyE;AACzE,2EAA2E;AAC3E,kBAAkB;AAClB,MAAM,UAAU,cAAc,CAAI,KAAQ;IACxC,OAAO,MAAM,CAAC,iBAAiB,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,2EAA2E;AAC3E,oBAAoB;AACpB,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,iBAAiB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,QAAQ,CAAC,MAAkB,EAAE,UAAkB;IACtD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,iEAAiE;YACjE,6CAA6C;YAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAAE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAClE,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAkB,EAAE,UAAkB;IAC1E,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,KAAK,CAAC;IAC1E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;YAC1B,IAAK,KAA+B,CAAC,IAAI,KAAK,cAAc;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;;gBACxE,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvB,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAI,KAA+B,EAAE,IAAI,CAAC;IACpD,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,cAAc,CAAC;AACtD,CAAC;AAKD,4EAA4E;AAC5E,wEAAwE;AACxE,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,OAAyC,EAAE,UAAkB;IACnG,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oEAAoE;QACpE,qDAAqD;QACrD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACxC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,cAAc,CAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=utils.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/node/utils.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,81 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import path from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import fs from 'node:fs';
6
+ import net from 'node:net';
7
+ import { spawn } from 'node:child_process';
8
+ import { getTmpSocketPath, listenExclusive, listenOnce, resolveService, sendTo, waitForService } from './utils.js';
9
+ const fixture = path.join(path.dirname(fileURLToPath(import.meta.url)), 'service.fixture.ts');
10
+ const run = (...args) => [process.execPath, ['--import', 'tsx', fixture, ...args]];
11
+ test('waitForService resolves with the value the child reports, leaving it running', async () => {
12
+ const { child, value } = await waitForService(...run('resolve', 'a', 'b'));
13
+ try {
14
+ assert.equal(value.pid, child.pid);
15
+ assert.deepEqual(value.args, ['a', 'b']);
16
+ assert.equal(child.exitCode, null);
17
+ }
18
+ finally {
19
+ child.kill();
20
+ }
21
+ });
22
+ test('waitForService rejects with the error the child reports', async () => {
23
+ await assert.rejects(waitForService(...run('reject')), /could not start/);
24
+ });
25
+ test('waitForService rejects when the child exits before reporting', async () => {
26
+ await assert.rejects(waitForService(...run('exit')), /exited \(3\) before resolving/);
27
+ });
28
+ test('waitForService rejects on timeout and kills the child', async () => {
29
+ await assert.rejects(waitForService(...run('silent'), { timeoutMs: 1 }), /did not resolve as a service within 1ms/);
30
+ });
31
+ test('resolveService throws outside of waitForService', () => {
32
+ assert.throws(() => resolveService(1), /was this process started by waitForService/);
33
+ });
34
+ test('listenExclusive lets only one server hold a socket', async () => {
35
+ const socketPath = getTmpSocketPath(`cmdless-test-${crypto.randomUUID()}`);
36
+ const first = net.createServer();
37
+ const second = net.createServer();
38
+ try {
39
+ assert.equal(await listenExclusive(first, socketPath), true);
40
+ assert.equal(await listenExclusive(second, socketPath), false);
41
+ if (process.platform !== 'win32')
42
+ assert.equal(fs.statSync(socketPath).mode & 0o777, 0o600);
43
+ }
44
+ finally {
45
+ first.close();
46
+ second.close();
47
+ }
48
+ });
49
+ test('listenExclusive replaces a socket nothing listens on', { skip: process.platform === 'win32' }, async () => {
50
+ const socketPath = getTmpSocketPath(`cmdless-test-${crypto.randomUUID()}`);
51
+ // a process that listens and is then killed outright leaves its socket file behind
52
+ const holder = spawn(process.execPath, ['-e', `require('net').createServer().listen(${JSON.stringify(socketPath)}, () => console.log('up'))`]);
53
+ await new Promise(resolve => holder.stdout.once('data', resolve));
54
+ holder.kill('SIGKILL');
55
+ await new Promise(resolve => holder.once('exit', resolve));
56
+ assert.ok(fs.existsSync(socketPath));
57
+ const server = net.createServer();
58
+ try {
59
+ assert.equal(await listenExclusive(server, socketPath), true);
60
+ }
61
+ finally {
62
+ server.close();
63
+ }
64
+ });
65
+ test('listenOnce resolves with the first message sent to it, then stops listening', async () => {
66
+ const once = await listenOnce();
67
+ await sendTo(once.socketPath, { type: 'resolve', value: { address: 'here' } });
68
+ assert.deepEqual(await once.message, { address: 'here' });
69
+ await new Promise(resolve => setTimeout(resolve, 10));
70
+ await assert.rejects(sendTo(once.socketPath, { type: 'resolve', value: { address: 'again' } }));
71
+ });
72
+ test('listenOnce rejects with a reject message, a hang-up, or the timeout', async () => {
73
+ const rejected = await listenOnce();
74
+ await sendTo(rejected.socketPath, { type: 'reject', error: 'no lock' });
75
+ await assert.rejects(rejected.message, /no lock/);
76
+ const hungUp = await listenOnce();
77
+ await new Promise(resolve => { const socket = net.createConnection(hungUp.socketPath, () => { socket.end(); resolve(); }); });
78
+ await assert.rejects(hungUp.message, /hung up/);
79
+ await assert.rejects((await listenOnce(1)).message, /nothing arrived within 1ms/);
80
+ });
81
+ //# sourceMappingURL=utils.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../src/node/utils.test.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,10 +1,39 @@
1
1
  {
2
2
  "name": "@cmdless/core",
3
- "version": "0.0.0",
4
- "description": "OIDC trusted publishing setup package for @cmdless/core",
5
- "keywords": [
6
- "oidc",
7
- "trusted-publishing",
8
- "setup"
9
- ]
3
+ "description": "Generic process, locking, and service primitives shared across cmdless packages.",
4
+ "version": "0.0.1",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "author": {
8
+ "name": "Fluttershy",
9
+ "url": "https://github.com/Fluttershy"
10
+ },
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "git+https://github.com/cmdless/electron.git"
14
+ },
15
+ "exports": {
16
+ "./node": {
17
+ "types": "./dist/node/index.d.ts",
18
+ "import": "./dist/node/index.js"
19
+ },
20
+ "./browser": {
21
+ "types": "./dist/browser/index.d.ts",
22
+ "import": "./dist/browser/index.js"
23
+ },
24
+ ".": {
25
+ "types": "./dist/index.d.ts",
26
+ "import": "./dist/index.js"
27
+ }
28
+ },
29
+ "files": [
30
+ "dist/",
31
+ "LICENSE",
32
+ "README.md"
33
+ ],
34
+ "scripts": {
35
+ "prebuild": "rimraf dist node_modules/.tmp",
36
+ "build": "tsc -b",
37
+ "test": "node ../../scripts/run-tests.mjs"
38
+ }
10
39
  }
package/README.md DELETED
@@ -1,45 +0,0 @@
1
- # @cmdless/core
2
-
3
- ## ⚠️ IMPORTANT NOTICE ⚠️
4
-
5
- **This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
6
-
7
- This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
8
-
9
- ## Purpose
10
-
11
- This package exists to:
12
- 1. Configure OIDC trusted publishing for the package name `@cmdless/core`
13
- 2. Enable secure, token-less publishing from CI/CD workflows
14
- 3. Establish provenance for packages published under this name
15
-
16
- ## What is OIDC Trusted Publishing?
17
-
18
- OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
19
-
20
- ## Setup Instructions
21
-
22
- To properly configure OIDC trusted publishing for this package:
23
-
24
- 1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
25
- 2. Configure the trusted publisher (e.g., GitHub Actions)
26
- 3. Specify the repository and workflow that should be allowed to publish
27
- 4. Use the configured workflow to publish your actual package
28
-
29
- ## DO NOT USE THIS PACKAGE
30
-
31
- This package is a placeholder for OIDC configuration only. It:
32
- - Contains no executable code
33
- - Provides no functionality
34
- - Should not be installed as a dependency
35
- - Exists only for administrative purposes
36
-
37
- ## More Information
38
-
39
- For more details about npm's trusted publishing feature, see:
40
- - [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
41
- - [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
42
-
43
- ---
44
-
45
- **Maintained for OIDC setup purposes only**