@powerhousedao/shared 6.0.0-staging.4 → 6.0.0

package/dist/registry/index.d.ts

@@ -0,0 +1,80 @@
+import { B as RegistryPackageStatus, F as PackageInfo, I as RegistryPackage, L as RegistryPackageList, R as RegistryPackageMap, kt as DEFAULT_REGISTRY_URL, z as RegistryPackageSource } from "../types-WzwAClp2.js";
+
+//#region registry/registry.d.ts
+/**
+ * Extract the host portion of a registry URL — what npm uses as the key in
+ * `~/.npmrc` for per-registry tokens (e.g. `//registry.dev.vetra.io/`).
+ */
+declare function registryAuthKey(registryUrl: string): string;
+interface ResolveRegistryUrlOptions {
+  /** Explicit registry URL (e.g. from --registry flag). Highest priority. */
+  registry?: string;
+  /** Project path to read powerhouse.config.json from. */
+  projectPath: string;
+  /** Environment variables. Defaults to process.env. */
+  env?: Record<string, string | undefined>;
+}
+/**
+ * Resolve the registry URL with priority: flag > env > config > default.
+ */
+declare function resolveRegistryUrl(options: ResolveRegistryUrlOptions): string;
+/**
+ * Check if the user is authenticated with the given npm registry.
+ * Returns the username on success, throws on failure.
+ */
+declare function checkNpmAuth(registryUrl: string): Promise<string>;
+interface NpmPublishOptions {
+  /** Registry URL to publish to. */
+  registryUrl: string;
+  /** Working directory (project root). */
+  cwd: string;
+  /** Additional arguments forwarded to npm publish. */
+  args?: string[];
+  /** Bearer token for the registry. When set, passed via a registry-scoped
+   *  `_authToken` config flag rather than read from the user's `.npmrc`. */
+  authToken?: string;
+}
+interface NpmPublishResult {
+  /** stdout from npm publish. */
+  stdout: string;
+}
+/**
+ * Run `npm publish` against the given registry.
+ * Uses spawn with args array to avoid shell injection.
+ *
+ * When `authToken` is provided, the token is passed via a registry-scoped
+ * `--//host/:_authToken=<token>` flag (npm's standard form for per-registry
+ * tokens) so we never have to write to `~/.npmrc`.
+ */
+declare function npmPublish(options: NpmPublishOptions): Promise<NpmPublishResult>;
+/**
+ * Write `_authToken=<token>` for the given registry host into `~/.npmrc`,
+ * preserving any other lines. Replaces the existing entry for the same key
+ * if present. Returns the absolute path to the npmrc that was written.
+ */
+declare function writeRegistryAuthToken(registryUrl: string, token: string): Promise<string>;
+interface NpmUnpublishOptions {
+  /** Registry URL to unpublish from. */
+  registryUrl: string;
+  /** Working directory (project root). */
+  cwd: string;
+  /** Package spec: `<name>` (whole package) or `<name>@<version>` (single version). */
+  spec: string;
+  /** Additional arguments forwarded to npm unpublish. */
+  args?: string[];
+  /** Bearer token for the registry (same semantics as `NpmPublishOptions.authToken`). */
+  authToken?: string;
+}
+interface NpmUnpublishResult {
+  /** stdout from npm unpublish. */
+  stdout: string;
+}
+/**
+ * Run `npm unpublish` against the given registry.
+ * Always passes `--force` because npm otherwise refuses to unpublish packages
+ * older than 72h (a public-npmjs safeguard that doesn't apply to private registries).
+ */
+declare function npmUnpublish(options: NpmUnpublishOptions): Promise<NpmUnpublishResult>;
+//#endregion
+export { DEFAULT_REGISTRY_URL, NpmPublishOptions, NpmPublishResult, NpmUnpublishOptions, NpmUnpublishResult, PackageInfo, RegistryPackage, RegistryPackageList, RegistryPackageMap, RegistryPackageSource, RegistryPackageStatus, ResolveRegistryUrlOptions, checkNpmAuth, npmPublish, npmUnpublish, registryAuthKey, resolveRegistryUrl, writeRegistryAuthToken };
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../registry/registry.ts"],"mappings":";;;;;;;iBAgBgB,eAAA,CAAgB,WAAA;AAAA,UAQf,yBAAA;;EAEf,QAAA;EAViD;EAYjD,WAAA;EAJwC;EAMxC,GAAA,GAAM,MAAA;AAAA;;;;iBAMQ,kBAAA,CAAmB,OAAA,EAAS,yBAAA;;;AAA5C;;iBAiBsB,YAAA,CAAa,WAAA,WAAsB,OAAA;AAAA,UAIxC,iBAAA;EArBoD;EAuBnE,WAAA;EANgC;EAQhC,GAAA;EARiC;EAUjC,IAAA;EANe;;EASf,SAAA;AAAA;AAAA,UAGe,gBAAA;EARf;EAUA,MAAA;AAAA;;;AAFF;;;;;AAaA;iBAAsB,UAAA,CACpB,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,gBAAA;;;;;;iBAeW,sBAAA,CACpB,WAAA,UACA,KAAA,WACC,OAAA;AAAA,UAmBc,mBAAA;EAtCf;EAwCA,WAAA;EAvCS;EAyCT,GAAA;EAzCyB;EA2CzB,IAAA;EA5B0C;EA8B1C,IAAA;EA3BQ;EA6BR,SAAA;AAAA;AAAA,UAGe,kBAAA;EAhCP;EAkCR,MAAA;AAAA;;;;;;iBAQoB,YAAA,CACpB,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,kBAAA"}

package/dist/registry/index.js

@@ -0,0 +1,157 @@
+import { promises, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+const DEFAULT_REGISTRY_URL = "https://registry.dev.vetra.io";
+const POWERHOUSE_CONFIG_FILE = "powerhouse.config.json";
+join(homedir(), ".ph");
+const VERSIONED_PEER_DEPENDENCIES = ["document-model", "@powerhousedao/reactor-browser"];
+const FEATURE_DEPENDENCIES = { analyticsProcessor: {
+	peerVersioned: ["@powerhousedao/analytics-engine-core"],
+	peerExternal: {}
+} };
+[...VERSIONED_PEER_DEPENDENCIES, ...FEATURE_DEPENDENCIES.analyticsProcessor.peerVersioned];
+const DEFAULT_CONFIG = {
+	documentModelsDir: "./document-models",
+	editorsDir: "./editors",
+	processorsDir: "./processors",
+	subgraphsDir: "./subgraphs",
+	importScriptsDir: "./scripts",
+	skipFormat: false,
+	logLevel: "info",
+	auth: {
+		enabled: false,
+		admins: []
+	}
+};
+//#endregion
+//#region clis/file-system/get-config.ts
+function getConfig(path = "./powerhouse.config.json") {
+	let config = { ...DEFAULT_CONFIG };
+	try {
+		const configStr = readFileSync(path, "utf-8");
+		const userConfig = JSON.parse(configStr);
+		config = {
+			...config,
+			...userConfig
+		};
+	} catch {}
+	return config;
+}
+//#endregion
+//#region clis/file-system/spawn-async.ts
+function spawnAsync(command, args, options = {}) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(process.platform === "win32" && command === "npm" ? "npm.cmd" : command, args, {
+			cwd: options.cwd,
+			env: options.env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		let stdout = "";
+		let stderr = "";
+		child.stdout.on("data", (d) => {
+			stdout += d.toString();
+		});
+		child.stderr.on("data", (d) => {
+			stderr += d.toString();
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code === 0) resolve(stdout.trim());
+			else reject(new Error(stderr.trim() || `${command} exited with code ${code}`));
+		});
+	});
+}
+//#endregion
+//#region registry/registry.ts
+/**
+* Extract the host portion of a registry URL — what npm uses as the key in
+* `~/.npmrc` for per-registry tokens (e.g. `//registry.dev.vetra.io/`).
+*/
+function registryAuthKey(registryUrl) {
+	const url = new URL(registryUrl);
+	const path = url.pathname.endsWith("/") ? url.pathname : `${url.pathname}/`;
+	return `//${url.host}${path}:_authToken`;
+}
+/**
+* Resolve the registry URL with priority: flag > env > config > default.
+*/
+function resolveRegistryUrl(options) {
+	const { registry, projectPath, env = process.env } = options;
+	const config = getConfig(join(projectPath, POWERHOUSE_CONFIG_FILE));
+	return registry ?? env.PH_REGISTRY_URL ?? config.packageRegistryUrl ?? "https://registry.dev.vetra.io";
+}
+/**
+* Check if the user is authenticated with the given npm registry.
+* Returns the username on success, throws on failure.
+*/
+async function checkNpmAuth(registryUrl) {
+	return spawnAsync("npm", [
+		"whoami",
+		"--registry",
+		registryUrl
+	]);
+}
+/**
+* Run `npm publish` against the given registry.
+* Uses spawn with args array to avoid shell injection.
+*
+* When `authToken` is provided, the token is passed via a registry-scoped
+* `--//host/:_authToken=<token>` flag (npm's standard form for per-registry
+* tokens) so we never have to write to `~/.npmrc`.
+*/
+async function npmPublish(options) {
+	const { registryUrl, cwd, args = [], authToken } = options;
+	return { stdout: await spawnAsync("npm", [
+		"publish",
+		"--registry",
+		registryUrl,
+		...authToken ? [`--${registryAuthKey(registryUrl)}=${authToken}`] : [],
+		...args
+	], { cwd }) };
+}
+/**
+* Write `_authToken=<token>` for the given registry host into `~/.npmrc`,
+* preserving any other lines. Replaces the existing entry for the same key
+* if present. Returns the absolute path to the npmrc that was written.
+*/
+async function writeRegistryAuthToken(registryUrl, token) {
+	const npmrcPath = join(homedir(), ".npmrc");
+	const key = registryAuthKey(registryUrl);
+	let existing = "";
+	try {
+		existing = await promises.readFile(npmrcPath, "utf8");
+	} catch (err) {
+		if (err.code !== "ENOENT") throw err;
+	}
+	const filtered = existing.split("\n").filter((line) => !line.startsWith(`${key}=`));
+	while (filtered.length && filtered[filtered.length - 1] === "") filtered.pop();
+	filtered.push(`${key}=${token}`);
+	await promises.writeFile(npmrcPath, `${filtered.join("\n")}\n`, "utf8");
+	return npmrcPath;
+}
+/**
+* Run `npm unpublish` against the given registry.
+* Always passes `--force` because npm otherwise refuses to unpublish packages
+* older than 72h (a public-npmjs safeguard that doesn't apply to private registries).
+*/
+async function npmUnpublish(options) {
+	const { registryUrl, cwd, spec, args = [], authToken } = options;
+	return { stdout: await spawnAsync("npm", [
+		"unpublish",
+		spec,
+		"--registry",
+		registryUrl,
+		"--force",
+		...authToken ? [`--${registryAuthKey(registryUrl)}=${authToken}`] : [],
+		...args
+	], { cwd }) };
+}
+//#endregion
+export { DEFAULT_REGISTRY_URL, checkNpmAuth, npmPublish, npmUnpublish, registryAuthKey, resolveRegistryUrl, writeRegistryAuthToken };
+
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["fs"],"sources":["../../clis/constants.ts","../../clis/file-system/get-config.ts","../../clis/file-system/spawn-async.ts","../../registry/registry.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Manifest } from \"../document-model/types.js\";\nimport type { PowerhouseConfig } from \"./types.js\";\n\nexport const SERVICE_ACTIONS = [\n  \"start\",\n  \"stop\",\n  \"status\",\n  \"setup\",\n  \"restart\",\n] as const;\n\nexport const SECONDS_IN_DAY = 24 * 60 * 60;\nexport const DEFAULT_EXPIRY_DAYS = 7;\nexport const DEFAULT_EXPIRY_SECONDS = DEFAULT_EXPIRY_DAYS * SECONDS_IN_DAY;\n\nexport const DRIVES_PRESERVE_STRATEGIES = [\n  \"preserve-all\",\n  \"preserve-by-url-and-detach\",\n] as const;\n\nexport const LOG_LEVELS = [\n  \"debug\",\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"verbose\",\n] as const;\n\nexport const DEFAULT_TIMEOUT = 300 as const;\n\nexport const DEFAULT_CONNECT_STUDIO_PORT = 3000 as const;\n\nexport const DEFAULT_VETRA_CONNECT_PORT = 3001 as const;\n\nexport const DEFAULT_CONNECT_PREVIEW_PORT = 4173 as const;\n\nexport const DEFAULT_CONNECT_OUTDIR = \".ph/connect-build/dist/\" as const;\n\nexport const DEFAULT_RENOWN_URL = \"https://www.renown.id\" as const;\n\nexport const DEFAULT_REGISTRY_URL = \"https://registry.dev.vetra.io\" as const;\n\nexport const DEFAULT_SWITCHBOARD_PORT = 4001 as const;\n\nexport const DEFAULT_VETRA_DRIVE_ID = \"vetra\" as const;\n\nexport const MINIMUM_NODE_VERSION = \"24.0.0\" as const;\nexport const PH_BIN = \"ph-cli-legacy\" as const;\nexport const POWERHOUSE_CONFIG_FILE = \"powerhouse.config.json\" as const;\nexport const PH_GLOBAL_DIR_NAME = \".ph\" as const;\n// Keep PH_GLOBAL_PROJECT_NAME for backwards compatibility\nexport const PH_GLOBAL_PROJECT_NAME = PH_GLOBAL_DIR_NAME;\n\nexport const HOME_DIR = homedir();\n\nexport const POWERHOUSE_GLOBAL_DIR = join(HOME_DIR, PH_GLOBAL_DIR_NAME);\n\n// Workspace packages that go in peerDependencies of every generated project.\nexport const VERSIONED_PEER_DEPENDENCIES = [\n  \"document-model\",\n  \"@powerhousedao/reactor-browser\",\n];\n\ntype PeerSpec = { peer: string; dev: string };\n\nexport const REACTOR_API_PACKAGE = \"@powerhousedao/reactor-api\";\nexport const ANALYTICS_ENGINE_CORE_PACKAGE =\n  \"@powerhousedao/analytics-engine-core\";\nexport const GRAPHQL_PACKAGE = \"graphql\";\nexport const GRAPHQL_TAG_PACKAGE = \"graphql-tag\";\n\n// External peerDependencies of every generated project.\n// `peer` is the consumer-facing range; `dev` is the exact build-tested pin.\n// graphql / graphql-tag are always-on because the workspace packages pulled\n// in by every `ph init` project (codegen, reactor-api, reactor-browser,\n// vetra-packages) declare them as peers — even projects without subgraphs\n// need them in scope so pnpm hoists a single graphql instance.\nexport const PEER_EXTERNAL_DEPENDENCIES = {\n  [GRAPHQL_PACKAGE]: { peer: \"^16\", dev: \"16.12.0\" },\n  [GRAPHQL_TAG_PACKAGE]: { peer: \"^2\", dev: \"2.12.6\" },\n  react: { peer: \"^19\", dev: \"19.2.3\" },\n  \"react-dom\": { peer: \"^19\", dev: \"19.2.3\" },\n  zod: { peer: \"^4\", dev: \"4.3.6\" },\n} as const satisfies Record<string, PeerSpec>;\n\n// Per-feature deps added dynamically by codegen when required.\nexport const FEATURE_DEPENDENCIES = {\n  analyticsProcessor: {\n    peerVersioned: [ANALYTICS_ENGINE_CORE_PACKAGE],\n    peerExternal: {},\n  },\n} as const satisfies Record<\n  string,\n  { peerVersioned: readonly string[]; peerExternal: Record<string, PeerSpec> }\n>;\n\nexport const VERSIONED_DEPENDENCIES = [\n  ...VERSIONED_PEER_DEPENDENCIES,\n  ...FEATURE_DEPENDENCIES.analyticsProcessor.peerVersioned,\n];\n\n// Transitive dependencies whose postinstall scripts the generated project\n// trusts. Mirrors the `allowBuilds` map in the boilerplate's\n// pnpm-workspace.yaml and is also passed as `--allow-build` flags to\n// `pnpm dlx @powerhousedao/ph-cli init` so pnpm 11's strict-dep-builds\n// default doesn't prompt during the outer dlx download.\nexport const BOILERPLATE_ALLOWED_BUILDS = [\n  \"@apollo/protobufjs\",\n  \"@datadog/pprof\",\n  \"@parcel/watcher\",\n  \"esbuild\",\n  \"protobufjs\",\n] as const;\n\nexport const VERSIONED_DEV_DEPENDENCIES = [\n  \"@powerhousedao/ph-cli\",\n  \"@powerhousedao/reactor\",\n  \"@powerhousedao/shared\",\n  \"@powerhousedao/connect\",\n  \"@powerhousedao/design-system\",\n];\n\nexport const packageJsonExports = {\n  \".\": {\n    types: \"./dist/types/index.d.ts\",\n    browser: \"./dist/browser/index.js\",\n    node: \"./dist/node/index.mjs\",\n  },\n  \"./document-models\": {\n    types: \"./dist/types/document-models/index.d.ts\",\n    browser: \"./dist/browser/document-models/index.js\",\n    node: \"./dist/node/document-models/index.mjs\",\n  },\n  \"./document-models/*\": {\n    types: \"./dist/types/document-models/*/index.d.ts\",\n    browser: \"./dist/browser/document-models/*/index.js\",\n    node: \"./dist/node/document-models/*/index.mjs\",\n  },\n  \"./editors\": {\n    types: \"./dist/types/editors/index.d.ts\",\n    browser: \"./dist/browser/editors/index.js\",\n    node: \"./dist/node/editors/index.mjs\",\n  },\n  \"./editors/*\": {\n    types: \"./dist/types/editors/*/editor.d.ts\",\n    browser: \"./dist/browser/editors/*/editor.js\",\n    node: \"./dist/node/editors/*/editor.mjs\",\n  },\n  \"./subgraphs\": {\n    types: \"./dist/types/subgraphs/index.d.ts\",\n    browser: \"./dist/browser/subgraphs/index.js\",\n    node: \"./dist/node/subgraphs/index.mjs\",\n  },\n  \"./processors\": {\n    types: \"./dist/types/processors/index.d.ts\",\n    browser: \"./dist/browser/processors/index.js\",\n    node: \"./dist/node/processors/index.mjs\",\n  },\n  \"./manifest\": \"./dist/powerhouse.manifest.json\",\n  \"./style.css\": \"./dist/style.css\",\n} as const;\n\nexport const packageScripts = {\n  \"test:watch\": \"vitest\",\n  lint: \"eslint --config eslint.config.js --cache\",\n  \"lint:fix\": \"npm run lint -- --fix\",\n  tsc: \"tsc\",\n  \"tsc:watch\": \"tsc --watch\",\n  generate: \"ph-cli generate\",\n  connect: \"ph-cli connect\",\n  build: \"ph-cli build\",\n  reactor: \"ph-cli reactor\",\n  service: \"ph-cli service\",\n  vetra: \"ph-cli vetra\",\n  \"service-startup\":\n    \"bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-startup.sh\",\n  \"service-unstartup\":\n    \"bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-unstartup.sh\",\n} as const;\n\nexport const externalDependencies = {} as const;\n\nexport const externalDevDependencies = {\n  \"@electric-sql/pglite\": \"0.3.15\",\n  \"@electric-sql/pglite-tools\": \"0.2.20\",\n  \"@eslint/js\": \"^9.38.0\",\n  \"@powerhousedao/document-engineering\": \"1.40.5\",\n  \"@tailwindcss/cli\": \"^4.1.18\",\n  \"@tailwindcss/vite\": \"^4.1.18\",\n  \"@types/node\": \"^24.9.2\",\n  \"@types/react\": \"^19.2.3\",\n  \"@types/react-dom\": \"^19.2.3\",\n  \"@vitejs/plugin-react\": \"^6.0.1\",\n  \"@vitest/coverage-v8\": \"4.1.1\",\n  eslint: \"^9.38.0\",\n  \"eslint-config-prettier\": \"^10.1.8\",\n  \"eslint-plugin-prettier\": \"^5.5.4\",\n  \"eslint-plugin-react\": \"^7.37.5\",\n  \"eslint-plugin-react-hooks\": \"^7.0.1\",\n  globals: \"^16.4.0\",\n  tailwindcss: \"^4.1.16\",\n  typescript: \"^5.9.3\",\n  \"typescript-eslint\": \"^8.46.2\",\n  vite: \"^8.0.8\",\n  \"vite-tsconfig-paths\": \"6.1.1\",\n  vitest: \"4.1.1\",\n} as const;\n\nexport const defaultManifest: Manifest = {\n  name: \"\",\n  description: \"\",\n  category: \"\",\n  publisher: {\n    name: \"\",\n    url: \"\",\n  },\n  documentModels: [],\n  editors: [],\n  apps: [],\n  subgraphs: [],\n  processors: [],\n};\n\nconst DEFAULT_DOCUMENT_MODELS_DIR = \"./document-models\";\nconst DEFAULT_EDITORS_DIR = \"./editors\";\nconst DEFAULT_PROCESSORS_DIR = \"./processors\";\nconst DEFAULT_SUBGRAPHS_DIR = \"./subgraphs\";\nconst DEFAULT_IMPORT_SCRIPTS_DIR = \"./scripts\";\nconst DEFAULT_SKIP_FORMAT = false;\nconst DEFAULT_LOG_LEVEL = \"info\";\n\nexport const DEFAULT_CONFIG: PowerhouseConfig = {\n  documentModelsDir: DEFAULT_DOCUMENT_MODELS_DIR,\n  editorsDir: DEFAULT_EDITORS_DIR,\n  processorsDir: DEFAULT_PROCESSORS_DIR,\n  subgraphsDir: DEFAULT_SUBGRAPHS_DIR,\n  importScriptsDir: DEFAULT_IMPORT_SCRIPTS_DIR,\n  skipFormat: DEFAULT_SKIP_FORMAT,\n  logLevel: DEFAULT_LOG_LEVEL,\n  auth: {\n    enabled: false,\n    admins: [],\n  },\n};\n","import { readFileSync } from \"node:fs\";\nimport { DEFAULT_CONFIG } from \"../constants.js\";\nimport type { PowerhouseConfig } from \"../types.js\";\n\nexport function getConfig(path = \"./powerhouse.config.json\") {\n  let config: PowerhouseConfig = { ...DEFAULT_CONFIG };\n  try {\n    const configStr = readFileSync(path, \"utf-8\");\n    const userConfig = JSON.parse(configStr) as PowerhouseConfig;\n    config = { ...config, ...userConfig };\n  } catch {\n    // console.warn(\"No powerhouse.config.json found, using defaults\");\n  }\n\n  return config;\n}\n","import { spawn } from \"node:child_process\";\n\nexport function spawnAsync(\n  command: string,\n  args: string[],\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n  } = {},\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const cmd =\n      process.platform === \"win32\" && command === \"npm\" ? \"npm.cmd\" : command;\n\n    const child = spawn(cmd, args, {\n      cwd: options.cwd,\n      env: options.env,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout.on(\"data\", (d: Buffer) => {\n      stdout += d.toString();\n    });\n\n    child.stderr.on(\"data\", (d: Buffer) => {\n      stderr += d.toString();\n    });\n\n    child.on(\"error\", reject);\n\n    child.on(\"close\", (code) => {\n      if (code === 0) {\n        resolve(stdout.trim());\n      } else {\n        reject(\n          new Error(stderr.trim() || `${command} exited with code ${code}`),\n        );\n      }\n    });\n  });\n}\n","import { promises as fs } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n  DEFAULT_REGISTRY_URL,\n  POWERHOUSE_CONFIG_FILE,\n} from \"../clis/constants.js\";\nimport { getConfig } from \"../clis/file-system/get-config.js\";\nimport { spawnAsync } from \"../clis/file-system/spawn-async.js\";\n\nexport { DEFAULT_REGISTRY_URL } from \"../clis/constants.js\";\n\n/**\n * Extract the host portion of a registry URL — what npm uses as the key in\n * `~/.npmrc` for per-registry tokens (e.g. `//registry.dev.vetra.io/`).\n */\nexport function registryAuthKey(registryUrl: string): string {\n  const url = new URL(registryUrl);\n  // Always trailing slash; npm's lookup is exact-match against the leading\n  // path of the registry URL, with `//` prefix and trailing `/`.\n  const path = url.pathname.endsWith(\"/\") ? url.pathname : `${url.pathname}/`;\n  return `//${url.host}${path}:_authToken`;\n}\n\nexport interface ResolveRegistryUrlOptions {\n  /** Explicit registry URL (e.g. from --registry flag). Highest priority. */\n  registry?: string;\n  /** Project path to read powerhouse.config.json from. */\n  projectPath: string;\n  /** Environment variables. Defaults to process.env. */\n  env?: Record<string, string | undefined>;\n}\n\n/**\n * Resolve the registry URL with priority: flag > env > config > default.\n */\nexport function resolveRegistryUrl(options: ResolveRegistryUrlOptions): string {\n  const { registry, projectPath, env = process.env } = options;\n  const configPath = join(projectPath, POWERHOUSE_CONFIG_FILE);\n  const config = getConfig(configPath);\n\n  return (\n    registry ??\n    env.PH_REGISTRY_URL ??\n    config.packageRegistryUrl ??\n    DEFAULT_REGISTRY_URL\n  );\n}\n\n/**\n * Check if the user is authenticated with the given npm registry.\n * Returns the username on success, throws on failure.\n */\nexport async function checkNpmAuth(registryUrl: string): Promise<string> {\n  return spawnAsync(\"npm\", [\"whoami\", \"--registry\", registryUrl]);\n}\n\nexport interface NpmPublishOptions {\n  /** Registry URL to publish to. */\n  registryUrl: string;\n  /** Working directory (project root). */\n  cwd: string;\n  /** Additional arguments forwarded to npm publish. */\n  args?: string[];\n  /** Bearer token for the registry. When set, passed via a registry-scoped\n   *  `_authToken` config flag rather than read from the user's `.npmrc`. */\n  authToken?: string;\n}\n\nexport interface NpmPublishResult {\n  /** stdout from npm publish. */\n  stdout: string;\n}\n\n/**\n * Run `npm publish` against the given registry.\n * Uses spawn with args array to avoid shell injection.\n *\n * When `authToken` is provided, the token is passed via a registry-scoped\n * `--//host/:_authToken=<token>` flag (npm's standard form for per-registry\n * tokens) so we never have to write to `~/.npmrc`.\n */\nexport async function npmPublish(\n  options: NpmPublishOptions,\n): Promise<NpmPublishResult> {\n  const { registryUrl, cwd, args = [], authToken } = options;\n  const tokenArg = authToken\n    ? [`--${registryAuthKey(registryUrl)}=${authToken}`]\n    : [];\n  const npmArgs = [\"publish\", \"--registry\", registryUrl, ...tokenArg, ...args];\n  const stdout = await spawnAsync(\"npm\", npmArgs, { cwd });\n  return { stdout };\n}\n\n/**\n * Write `_authToken=<token>` for the given registry host into `~/.npmrc`,\n * preserving any other lines. Replaces the existing entry for the same key\n * if present. Returns the absolute path to the npmrc that was written.\n */\nexport async function writeRegistryAuthToken(\n  registryUrl: string,\n  token: string,\n): Promise<string> {\n  const npmrcPath = join(homedir(), \".npmrc\");\n  const key = registryAuthKey(registryUrl);\n  let existing = \"\";\n  try {\n    existing = await fs.readFile(npmrcPath, \"utf8\");\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") throw err;\n  }\n  const lines = existing.split(\"\\n\");\n  const filtered = lines.filter((line) => !line.startsWith(`${key}=`));\n  // Also drop any trailing empties to avoid stacking blank lines on rewrite.\n  while (filtered.length && filtered[filtered.length - 1] === \"\")\n    filtered.pop();\n  filtered.push(`${key}=${token}`);\n  await fs.writeFile(npmrcPath, `${filtered.join(\"\\n\")}\\n`, \"utf8\");\n  return npmrcPath;\n}\n\nexport interface NpmUnpublishOptions {\n  /** Registry URL to unpublish from. */\n  registryUrl: string;\n  /** Working directory (project root). */\n  cwd: string;\n  /** Package spec: `<name>` (whole package) or `<name>@<version>` (single version). */\n  spec: string;\n  /** Additional arguments forwarded to npm unpublish. */\n  args?: string[];\n  /** Bearer token for the registry (same semantics as `NpmPublishOptions.authToken`). */\n  authToken?: string;\n}\n\nexport interface NpmUnpublishResult {\n  /** stdout from npm unpublish. */\n  stdout: string;\n}\n\n/**\n * Run `npm unpublish` against the given registry.\n * Always passes `--force` because npm otherwise refuses to unpublish packages\n * older than 72h (a public-npmjs safeguard that doesn't apply to private registries).\n */\nexport async function npmUnpublish(\n  options: NpmUnpublishOptions,\n): Promise<NpmUnpublishResult> {\n  const { registryUrl, cwd, spec, args = [], authToken } = options;\n  const tokenArg = authToken\n    ? [`--${registryAuthKey(registryUrl)}=${authToken}`]\n    : [];\n  const npmArgs = [\n    \"unpublish\",\n    spec,\n    \"--registry\",\n    registryUrl,\n    \"--force\",\n    ...tokenArg,\n    ...args,\n  ];\n  const stdout = await spawnAsync(\"npm\", npmArgs, { cwd });\n  return { stdout };\n}\n"],"mappings":"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"}

package/dist/types-BFDlQkXZ.d.ts

@@ -0,0 +1,158 @@
+import { DateTime } from "luxon";
+
+//#region analytics/constants.d.ts
+declare enum AnalyticsSerializerTypes {
+  AnalyticsPath = 0,
+  AnalyticsPathSegment = 1,
+  AnalyticsPeriod = 2
+}
+declare enum AnalyticsPeriodType {
+  Year = 0,
+  Quarter = 1,
+  Month = 2
+}
+declare enum AnalyticsMetric {
+  Budget = 0,
+  Forecast = 1,
+  Actuals = 2,
+  PaymentsOnChain = 3,
+  PaymentsOffChainIncluded = 4,
+  FTEs = 5
+}
+declare enum CompoundOperator {
+  VectorAdd = 0,
+  VectorSubtract = 1,
+  ScalarMultiply = 2,
+  ScalarDivide = 3
+}
+declare enum AnalyticsGranularity {
+  Total = 0,
+  Annual = 1,
+  SemiAnnual = 2,
+  Quarterly = 3,
+  Monthly = 4,
+  Weekly = 5,
+  Daily = 6,
+  Hourly = 7
+}
+//#endregion
+//#region analytics/analytics-path.d.ts
+declare class AnalyticsPath {
+  get segments(): AnalyticsPathSegment[];
+  private _segments;
+  static fromString(path: string): AnalyticsPath;
+  static fromStringArray(segments: string[]): AnalyticsPath;
+  static fromArray(segments: AnalyticsPathSegment[]): AnalyticsPath;
+  static fromJSON(json: any): AnalyticsPath;
+  constructor(segments: AnalyticsPathSegment[]);
+  toJSON(): {
+    _t: AnalyticsSerializerTypes;
+    _v: string;
+  };
+  toString(tail?: string): string;
+  firstSegment(): AnalyticsPathSegment;
+  reduce(): AnalyticsPath;
+  applyLod(levelOfDetail: number): AnalyticsPath;
+}
+declare class AnalyticsPathSegment {
+  get filters(): NullableStrings;
+  get groups(): NullableStrings;
+  private _filters;
+  private _groups;
+  static fromString(segment: string): AnalyticsPathSegment;
+  static escape(segment: string): string;
+  static unescape(segment: string): string;
+  constructor(filters?: NullableStrings, groups?: NullableStrings);
+  toJSON(): {
+    _t: AnalyticsSerializerTypes;
+    _v: string;
+  };
+  toString(): string;
+}
+type NullableStrings = string[] | null;
+//#endregion
+//#region analytics/types.d.ts
+type AnalyticsSeriesQuery = {
+  start: DateTime | null;
+  end: DateTime | null;
+  metrics: string[];
+  currency?: AnalyticsPath;
+  select: Record<string, AnalyticsPath[]>;
+};
+type AnalyticsQuery = AnalyticsSeriesQuery & {
+  granularity: AnalyticsGranularity;
+  lod: Record<string, number | null>;
+};
+type AnalyticsSeries<D = string | AnalyticsDimension> = {
+  source: AnalyticsPath;
+  start: DateTime;
+  end: DateTime | null;
+  metric: string;
+  value: number;
+  unit: string | null;
+  fn: string;
+  params: Record<string, unknown> | null;
+  dimensions: Record<string, D>;
+};
+type AnalyticsDimension = {
+  path: AnalyticsPath;
+  icon: string;
+  label: string;
+  description: string;
+};
+type CompoundAnalyticsQuery = {
+  start: DateTime | null;
+  end: DateTime | null;
+  granularity: AnalyticsGranularity;
+  lod: Record<string, number | null>;
+  select: Record<string, AnalyticsPath[]>;
+  expression: CompoundAnalyticsExpression;
+};
+type CompoundAnalyticsExpression = {
+  inputs: CompoundAnalyticsInputs;
+  operator: CompoundOperator;
+  operand: AnalyticsOperand;
+  resultCurrency?: AnalyticsPath;
+};
+type CompoundAnalyticsInputs = {
+  metrics: string[];
+  currency?: AnalyticsPath;
+};
+type AnalyticsOperand = {
+  metric: string;
+  currency?: AnalyticsPath;
+  useSum: boolean;
+};
+type MultiCurrencyConversion = {
+  targetCurrency?: AnalyticsPath;
+  conversions: ConversionMetric[];
+};
+type ConversionMetric = {
+  metric: string;
+  currency?: AnalyticsPath;
+};
+type AnalyticsSeriesInput = {
+  start: DateTime;
+  end?: DateTime | null;
+  source: AnalyticsPath;
+  metric: string;
+  value: number;
+  unit?: string | null;
+  fn?: string | null;
+  params?: Record<string, any> | null;
+  dimensions: Record<string, AnalyticsPath>;
+  dimensionMetadata?: Record<string, string>;
+};
+type AnalyticsUpdateCallback = (source: AnalyticsPath) => void;
+interface IAnalyticsStore {
+  clearSeriesBySource: (source: AnalyticsPath, cleanUpDimensions?: boolean) => Promise<number>;
+  clearEmptyAnalyticsDimensions: () => Promise<number>;
+  getMatchingSeries: (query: AnalyticsSeriesQuery) => Promise<AnalyticsSeries[]>;
+  addSeriesValue: (input: AnalyticsSeriesInput) => Promise<void>;
+  addSeriesValues: (inputs: AnalyticsSeriesInput[]) => Promise<void>;
+  getDimensions: () => Promise<any>;
+  subscribeToSource: (source: AnalyticsPath, callback: AnalyticsUpdateCallback) => () => void;
+}
+//#endregion
+export { AnalyticsMetric as _, AnalyticsSeriesInput as a, CompoundOperator as b, CompoundAnalyticsExpression as c, ConversionMetric as d, IAnalyticsStore as f, AnalyticsGranularity as g, AnalyticsPathSegment as h, AnalyticsSeries as i, CompoundAnalyticsInputs as l, AnalyticsPath as m, AnalyticsOperand as n, AnalyticsSeriesQuery as o, MultiCurrencyConversion as p, AnalyticsQuery as r, AnalyticsUpdateCallback as s, AnalyticsDimension as t, CompoundAnalyticsQuery as u, AnalyticsPeriodType as v, AnalyticsSerializerTypes as y };
+//# sourceMappingURL=types-BFDlQkXZ.d.ts.map

package/dist/types-BFDlQkXZ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BFDlQkXZ.d.ts","names":[],"sources":["../analytics/constants.ts","../analytics/analytics-path.ts","../analytics/types.ts"],"mappings":";;;aAAY,wBAAA;EACV,aAAA;EACA,oBAAA;EACA,eAAA;AAAA;AAAA,aAGU,mBAAA;EACV,IAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,aAGU,eAAA;EACV,MAAA;EACA,QAAA;EACA,OAAA;EACA,eAAA;EACA,wBAAA;EACA,IAAA;AAAA;AAAA,aAEU,gBAAA;EACV,SAAA;EACA,cAAA;EACA,cAAA;EACA,YAAA;AAAA;AAAA,aAEU,oBAAA;EACV,KAAA;EACA,MAAA;EACA,UAAA;EACA,SAAA;EACA,OAAA;EACA,MAAA;EACA,KAAA;EACA,MAAA;AAAA;;;cC5BW,aAAA;EAAA,IACP,QAAA,CAAA,GAAY,oBAAA;EAAA,QAIR,SAAA;EAAA,OAEM,UAAA,CAAW,IAAA,WAAe,aAAA;EAAA,OAQ1B,eAAA,CAAgB,QAAA,aAAqB,aAAA;EAAA,OAMrC,SAAA,CAAU,QAAA,EAAU,oBAAA,KAAyB,aAAA;EAAA,OAI7C,QAAA,CAAS,IAAA,QAAY,aAAA;cAOvB,QAAA,EAAU,oBAAA;EAIf,MAAA,CAAA;;;;EAOA,QAAA,CAAS,IAAA;EAIT,YAAA,CAAA,GAAgB,oBAAA;EAMhB,MAAA,CAAA,GAAU,aAAA;EAUV,QAAA,CAAS,aAAA,WAAwB,aAAA;AAAA;AAAA,cAW7B,oBAAA;EAAA,IACP,OAAA,CAAA,GAAW,eAAA;EAAA,IAGX,MAAA,CAAA,GAAU,eAAA;EAAA,QAIN,QAAA;EAAA,QACA,OAAA;EAAA,OAEM,UAAA,CAAW,OAAA,WAAkB,oBAAA;EAAA,OA0B7B,MAAA,CAAO,OAAA;EAAA,OAKP,QAAA,CAAS,OAAA;cAKX,OAAA,GAAS,eAAA,EAAwB,MAAA,GAAQ,eAAA;EAK9C,MAAA,CAAA;;;;EAOA,QAAA,CAAA;AAAA;AAAA,KAsBJ,eAAA;;;KC7JO,oBAAA;EACV,KAAA,EAAO,QAAA;EACP,GAAA,EAAK,QAAA;EACL,OAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA,EAAQ,MAAA,SAAe,aAAA;AAAA;AAAA,KAEb,cAAA,GAAiB,oBAAA;EAC3B,WAAA,EAAa,oBAAA;EACb,GAAA,EAAK,MAAA;AAAA;AAAA,KAEK,eAAA,cAA6B,kBAAA;EACvC,MAAA,EAAQ,aAAA;EACR,KAAA,EAAO,QAAA;EACP,GAAA,EAAK,QAAA;EACL,MAAA;EACA,KAAA;EACA,IAAA;EACA,EAAA;EACA,MAAA,EAAQ,MAAA;EACR,UAAA,EAAY,MAAA,SAAe,CAAA;AAAA;AAAA,KAEjB,kBAAA;EACV,IAAA,EAAM,aAAA;EACN,IAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,KAEU,sBAAA;EACV,KAAA,EAAO,QAAA;EACP,GAAA,EAAK,QAAA;EACL,WAAA,EAAa,oBAAA;EACb,GAAA,EAAK,MAAA;EACL,MAAA,EAAQ,MAAA,SAAe,aAAA;EACvB,UAAA,EAAY,2BAAA;AAAA;AAAA,KAEF,2BAAA;EACV,MAAA,EAAQ,uBAAA;EACR,QAAA,EAAU,gBAAA;EACV,OAAA,EAAS,gBAAA;EACT,cAAA,GAAiB,aAAA;AAAA;AAAA,KAEP,uBAAA;EACV,OAAA;EACA,QAAA,GAAW,aAAA;AAAA;AAAA,KAED,gBAAA;EACV,MAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA;AAAA;AAAA,KAEU,uBAAA;EACV,cAAA,GAAiB,aAAA;EACjB,WAAA,EAAa,gBAAA;AAAA;AAAA,KAEH,gBAAA;EACV,MAAA;EACA,QAAA,GAAW,aAAA;AAAA;AAAA,KAGD,oBAAA;EACV,KAAA,EAAO,QAAA;EACP,GAAA,GAAM,QAAA;EACN,MAAA,EAAQ,aAAA;EACR,MAAA;EACA,KAAA;EACA,IAAA;EACA,EAAA;EACA,MAAA,GAAS,MAAA;EACT,UAAA,EAAY,MAAA,SAAe,aAAA;EAC3B,iBAAA,GAAoB,MAAA;AAAA;AAAA,KAGV,uBAAA,IAA2B,MAAA,EAAQ,aAAA;AAAA,UAE9B,eAAA;EACf,mBAAA,GACE,MAAA,EAAQ,aAAA,EACR,iBAAA,eACG,OAAA;EACL,6BAAA,QAAqC,OAAA;EACrC,iBAAA,GACE,KAAA,EAAO,oBAAA,KACJ,OAAA,CAAQ,eAAA;EACb,cAAA,GAAiB,KAAA,EAAO,oBAAA,KAAyB,OAAA;EACjD,eAAA,GAAkB,MAAA,EAAQ,oBAAA,OAA2B,OAAA;EACrD,aAAA,QAAqB,OAAA;EAErB,iBAAA,GACE,MAAA,EAAQ,aAAA,EACR,QAAA,EAAU,uBAAA;AAAA"}