@theholocron/cli 5.0.0-alpha.329 → 5.0.0-alpha.330
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/dist/cli.mjs +219 -7
- package/dist/cli.mjs.map +1 -1
- package/dist/{compose-C3tl5zsP.mjs → compose-DU_NeIR0.mjs} +7 -0
- package/dist/{index-BgltZujd.d.mts → index-CsLdvk4-.d.mts} +22 -1
- package/dist/index.d.mts +2 -2
- package/dist/index.mjs +1 -1
- package/dist/presets.d.mts +1 -1
- package/dist/presets.mjs +1 -1
- package/package.json +7 -6
|
@@ -84,6 +84,13 @@ function validateDev(dev) {
|
|
|
84
84
|
}
|
|
85
85
|
if (dev.port !== void 0 && !(Number.isInteger(dev.port) && dev.port >= 1 && dev.port <= 65535)) throw new ConfigError(`\`dev.port\` must be a port from 1 to 65535, got ${JSON.stringify(dev.port)}`);
|
|
86
86
|
if (dev.command !== void 0 && !(Array.isArray(dev.command) && dev.command.length > 0 && dev.command.every(nonEmpty))) throw new ConfigError("`dev.command` must be the program and its arguments, e.g. [\"pnpm\", \"run\", \"serve\"]");
|
|
87
|
+
if (dev.serve !== void 0) {
|
|
88
|
+
const { serve } = dev;
|
|
89
|
+
if (!nonEmpty(serve.handler)) throw new ConfigError("`dev.serve.handler` must be the path of the module that exports the handler");
|
|
90
|
+
if (serve.export !== void 0 && !nonEmpty(serve.export)) throw new ConfigError("`dev.serve.export` must be the name of the handler's export, got an empty value");
|
|
91
|
+
if (serve.required !== void 0 && !(Array.isArray(serve.required) && serve.required.every(nonEmpty))) throw new ConfigError("`dev.serve.required` must be a list of variable names");
|
|
92
|
+
if (serve.logging !== void 0 && !(nonEmpty(serve.logging.tokenVar) && nonEmpty(serve.logging.datasetVar))) throw new ConfigError("`dev.serve.logging` needs a `tokenVar` and a `datasetVar`, both variable names");
|
|
93
|
+
}
|
|
87
94
|
}
|
|
88
95
|
/** The values `repoValidation.docsCoverage` accepts. */
|
|
89
96
|
const DOCS_COVERAGE_MODES = [
|
|
@@ -254,6 +254,27 @@ interface DevConfig {
|
|
|
254
254
|
port?: number;
|
|
255
255
|
/** The application's command and arguments, e.g. `["pnpm", "run", "serve"]`. */
|
|
256
256
|
command?: string[];
|
|
257
|
+
/**
|
|
258
|
+
* A web-standard handler for `holocron dev` to serve itself, in place of `command`: the application is then
|
|
259
|
+
* `holocron dev serve`, which loads the handler and serves it on `PORT`. `command` and a command after `--` win.
|
|
260
|
+
*/
|
|
261
|
+
serve?: DevServeConfig;
|
|
262
|
+
}
|
|
263
|
+
/** The `dev.serve` block: the handler `holocron dev` serves, and the variables it needs. */
|
|
264
|
+
interface DevServeConfig {
|
|
265
|
+
/** The module that exports the handler, relative to the directory, e.g. `./src/handler/index.ts`. TypeScript is loaded as is. */
|
|
266
|
+
handler: string;
|
|
267
|
+
/** The name of the handler's export. Defaults to `default`. */
|
|
268
|
+
export?: string;
|
|
269
|
+
/** The variables the handler cannot run without. Missing ones are named; nothing starts. */
|
|
270
|
+
required?: string[];
|
|
271
|
+
/** The variables holding the Axiom ingest token and dataset, to say where this run's logs go. */
|
|
272
|
+
logging?: {
|
|
273
|
+
/** The variable holding the Axiom ingest token. Only its presence is reported, never its value. */
|
|
274
|
+
tokenVar: string;
|
|
275
|
+
/** The variable holding the Axiom dataset the app's logs go to. */
|
|
276
|
+
datasetVar: string;
|
|
277
|
+
};
|
|
257
278
|
}
|
|
258
279
|
/** The `env` block: how the project's environment variables are named and documented. */
|
|
259
280
|
interface EnvConfig {
|
|
@@ -809,4 +830,4 @@ interface ComposedPreset {
|
|
|
809
830
|
* const preset = compose(node(), nextjs());
|
|
810
831
|
*/
|
|
811
832
|
declare function compose(...args: (Capability | Capability[])[]): ComposedPreset;
|
|
812
|
-
export {
|
|
833
|
+
export { RepoSecretsSync as A, TelemetryConfig as B, ProviderOptions as C, RepoProperties as D, RepoConfig as E, ResolvedProvidersConfig as F, ResolvedTuple as I, SingleEntry as L, RepoVariables as M, ResolvedHolocronConfig as N, RepoProtection as O, ResolvedProviderEntry as P, StorybookDeployProject as R, MultiEntry as S, RawProvidersConfig as T, WorkflowWithConfig as V, DoctorConfig as _, ConfigError as a, HolocronConfig as b, resolveEntry as c, CapabilityConfigPackage as d, ChromaticProjectConfig as f, DocsConfig as g, DevServeConfig as h, TaskEntry as i, RepoValidationConfig as j, RepoSecrets as k, resolvePluginPackage as l, DevConfig as m, Capability as n, credentialsEnvironment as o, CredentialsConfig as p, ComposedPreset as r, resolveConfig as s, compose as t, AppConfig as u, EnvConfig as v, RawProviderEntry as w, LogConfig as x, EslintConfig as y, TaskEntryConfig as z };
|
package/dist/index.d.mts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { $ as Environments, $t as SourceFile, A as DeployScriptResult, At as NotificationsMember, B as DnsRecord, Bt as ParseWebhookInput, C as ConnectionStringOptions, Ct as NotificationsApplicationLayout, D as DeployFunctionConfig, Dt as NotificationsForumTag, E as CredentialsInspection, Et as NotificationsEveryoneLayout, F as DeploymentTarget, Ft as NotificationsServerLayout, G as EnsureRelayResult, Gt as RepoSettings, H as DnsRecordType, Ht as PullRequest, I as DeploymentTrigger, It as NotificationsSignIn, J as EnsuredDiscussion, Jt as SecretScope, K as EnsureResult, Kt as ResolvedCapability, L as DiscussionPatch, Lt as NotificationsSignedIn, M as DeploymentProject, Mt as NotificationsOnboardingLayout, N as DeploymentProjectSettings, Nt as NotificationsPicture, O as DeployFunctionResult, Ot as NotificationsLayout, P as DeploymentRecord, Pt as NotificationsPinnedLayout, Q as EnvironmentReviewer, Qt as SourceBranch, R as DiscussionPost, Rt as NotificationsWelcomeLayout, S as CiRunStatus, St as NotificationsAccess, T as Credentials, Tt as NotificationsDelivery, U as EnsureDiscussionInput, Ut as RelayState, V as DnsRecordRequest, Vt as ProviderIdentity, W as EnsureRelayInput, Wt as RepoRef, X as EnsuredTunnel, Xt as ServerInspection, Y as EnsuredResource, Yt as Secrets, Z as Environment, Zt as Source, _ as Cardinality, _n as Wiki, _t as MonitoringCheck, a as REQUIRED_CAPABILITIES, an as Storage, at as LabelDef, b as CiRun, bn as WorkerScriptState, bt as NormalizedAuthUser, c as Analytics, cn as TeamPermission, ct as Logs, d as AuthEvent, dn as TrackerDoctorReport, dt as MonitoringAlertChannelResult, en as SourceRepoInfo, et as Errors, f as AuthEventType, fn as TrackerUser, ft as MonitoringAlertChannelState, g as CapabilityKey, gn as WebhookDashboardInfo, gt as MonitoringAssertionSource, h as CapabilityImpls, hn as Vault, ht as MonitoringAssertionComparison, i as ProviderApiError, in as StatusCategory, it as Issues, j as Deployment, jt as NotificationsMonitoringFeed, k as DeployScriptConfig, kt as NotificationsLinksLayout, l as Auth, ln as Tooling, lt as Monitoring, m as AuthUser, mn as Tunnels, mt as MonitoringAssertion, n as ElevationRequiredError, nn as SourceSecurity, nt as Issue, o as WebhookVerificationError, on as StorageBranch, ot as LifecycleResult, p as AuthIdentity, pn as TunnelRoute, pt as MonitoringAlertSettings, q as EnsureWebhookResult, qt as Ruleset, r as MissingTokenError, rn as SourceTeamMember, rt as IssueSearchFilter, s as isMulti, sn as TeamEntry, st as LifecycleSlot, t as CARDINALITY, tn as SourceRulesetDetail, tt as InspectRelayInput, u as AuthDescription, un as ToolingDoctorReport, ut as MonitoringAlertChannelInput, v as CardinalityFor, vn as WikiProvisionOpts, vt as MonitoringCheckInput, w as CreateAuthUserInput, wt as NotificationsChannelLayout, x as CiRunFilter, xn as Workers, xt as Notifications, y as Ci, yn as WikiProxyConfig, yt as MonitoringHttpMethod, z as Dns, zt as PagesConfig } from "./index-KMWrNLpJ.mjs";
|
|
2
|
-
import { A as
|
|
2
|
+
import { A as RepoSecretsSync, B as TelemetryConfig, C as ProviderOptions, D as RepoProperties, E as RepoConfig, F as ResolvedProvidersConfig, I as ResolvedTuple, L as SingleEntry, M as RepoVariables, N as ResolvedHolocronConfig, O as RepoProtection, P as ResolvedProviderEntry, R as StorybookDeployProject, S as MultiEntry, T as RawProvidersConfig, V as WorkflowWithConfig, _ as DoctorConfig, a as ConfigError, b as HolocronConfig, c as resolveEntry, d as CapabilityConfigPackage, f as ChromaticProjectConfig, g as DocsConfig, h as DevServeConfig, i as TaskEntry, j as RepoValidationConfig, k as RepoSecrets, l as resolvePluginPackage, m as DevConfig, n as Capability, o as credentialsEnvironment, p as CredentialsConfig, r as ComposedPreset, s as resolveConfig, t as compose, u as AppConfig, v as EnvConfig, w as RawProviderEntry, x as LogConfig, y as EslintConfig, z as TaskEntryConfig } from "./index-CsLdvk4-.mjs";
|
|
3
3
|
import { AuthError, RequestOptions, ResolveTokenConfig as ResolveTokenConfig$1, ResolveTokenInput, ResolveTokenInput as ResolveTokenInput$1, RestClient, RestClientConfig, createRestClient } from "@theholocron/http-client";
|
|
4
4
|
import { PackageJson } from "@theholocron/pkg-utils";
|
|
5
5
|
import { WorkspacePackage } from "@theholocron/astromech";
|
|
@@ -398,4 +398,4 @@ export declare function missingCapabilities(capabilities: readonly string[]): st
|
|
|
398
398
|
* own soft-fail behavior.
|
|
399
399
|
*/
|
|
400
400
|
export declare function readWorkspacePackageJsons(repoRoot: string, workspacePackages: readonly WorkspacePackage[]): Promise<PackageJsonLike[]>;
|
|
401
|
-
export { Analytics, type AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, type Capability, type CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, type ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, type ComposedPreset, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Credentials, type CredentialsConfig, CredentialsInspection, DeployFunctionConfig, DeployFunctionResult, DeployScriptConfig, DeployScriptResult, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, type DeriveProfileInput, type DevConfig, DiscussionPatch, DiscussionPost, Dns, DnsRecord, DnsRecordRequest, DnsRecordType, type DocsConfig, type DoctorConfig, ElevationRequiredError, EnsureDiscussionInput, EnsureRelayInput, EnsureRelayResult, EnsureResult, EnsureWebhookResult, EnsuredDiscussion, EnsuredResource, EnsuredTunnel, type EnvConfig, Environment, EnvironmentReviewer, Environments, Errors, type EslintConfig, type FeatureResolver, type FeatureResolverConfig, type HolocronConfig, type HolocronProfile, InspectRelayInput, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, type LinksFile, type LoadedConfig, type LogConfig, Logs, type MemberLink, MissingTokenError, Monitoring, MonitoringAlertChannelInput, MonitoringAlertChannelResult, MonitoringAlertChannelState, MonitoringAlertSettings, MonitoringAssertion, MonitoringAssertionComparison, MonitoringAssertionSource, MonitoringCheck, MonitoringCheckInput, MonitoringHttpMethod, type MultiEntry, NormalizedAuthUser, Notifications, NotificationsAccess, NotificationsApplicationLayout, NotificationsChannelLayout, NotificationsDelivery, NotificationsEveryoneLayout, NotificationsForumTag, NotificationsLayout, NotificationsLinksLayout, NotificationsMember, NotificationsMonitoringFeed, NotificationsOnboardingLayout, NotificationsPicture, NotificationsPinnedLayout, NotificationsServerLayout, NotificationsSignIn, NotificationsSignedIn, NotificationsWelcomeLayout, type PackageJsonLike, PagesConfig, ParseWebhookInput, type PluginProbes, type PluginToken, type Probe, type ProbeContext, type ProbeRow, ProviderApiError, ProviderIdentity, type ProviderOptions, PullRequest, REQUIRED_CAPABILITIES, type RawProviderEntry, type RawProvidersConfig, RelayState, type RepoConfig, type RepoProperties, type RepoProtection, RepoRef, type RepoSecrets, type RepoSecretsSync, RepoSettings, type RepoValidationConfig, type RepoVariables, type RequestOptions, type ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, type ResolvedHolocronConfig, type ResolvedProviderEntry, type ResolvedProvidersConfig, type ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, ServerInspection, type SingleEntry, Source, SourceBranch, SourceFile, SourceRepoInfo, SourceRulesetDetail, SourceSecurity, SourceTeamMember, StatusCategory, Storage, StorageBranch, type StorybookDeployProject, type SyncRolesInput, type SyncRolesResult, type TaskEntry, type TaskEntryConfig, TeamEntry, TeamPermission, type TelemetryConfig, type TokenResolver, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, TunnelRoute, Tunnels, Vault, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiProvisionOpts, WikiProxyConfig, WorkerScriptState, Workers, type WorkflowWithConfig, compose, createRestClient, credentialsEnvironment, isMulti, resolveConfig, resolveEntry, resolvePluginPackage };
|
|
401
|
+
export { Analytics, type AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, type Capability, type CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, type ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, type ComposedPreset, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Credentials, type CredentialsConfig, CredentialsInspection, DeployFunctionConfig, DeployFunctionResult, DeployScriptConfig, DeployScriptResult, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, type DeriveProfileInput, type DevConfig, type DevServeConfig, DiscussionPatch, DiscussionPost, Dns, DnsRecord, DnsRecordRequest, DnsRecordType, type DocsConfig, type DoctorConfig, ElevationRequiredError, EnsureDiscussionInput, EnsureRelayInput, EnsureRelayResult, EnsureResult, EnsureWebhookResult, EnsuredDiscussion, EnsuredResource, EnsuredTunnel, type EnvConfig, Environment, EnvironmentReviewer, Environments, Errors, type EslintConfig, type FeatureResolver, type FeatureResolverConfig, type HolocronConfig, type HolocronProfile, InspectRelayInput, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, type LinksFile, type LoadedConfig, type LogConfig, Logs, type MemberLink, MissingTokenError, Monitoring, MonitoringAlertChannelInput, MonitoringAlertChannelResult, MonitoringAlertChannelState, MonitoringAlertSettings, MonitoringAssertion, MonitoringAssertionComparison, MonitoringAssertionSource, MonitoringCheck, MonitoringCheckInput, MonitoringHttpMethod, type MultiEntry, NormalizedAuthUser, Notifications, NotificationsAccess, NotificationsApplicationLayout, NotificationsChannelLayout, NotificationsDelivery, NotificationsEveryoneLayout, NotificationsForumTag, NotificationsLayout, NotificationsLinksLayout, NotificationsMember, NotificationsMonitoringFeed, NotificationsOnboardingLayout, NotificationsPicture, NotificationsPinnedLayout, NotificationsServerLayout, NotificationsSignIn, NotificationsSignedIn, NotificationsWelcomeLayout, type PackageJsonLike, PagesConfig, ParseWebhookInput, type PluginProbes, type PluginToken, type Probe, type ProbeContext, type ProbeRow, ProviderApiError, ProviderIdentity, type ProviderOptions, PullRequest, REQUIRED_CAPABILITIES, type RawProviderEntry, type RawProvidersConfig, RelayState, type RepoConfig, type RepoProperties, type RepoProtection, RepoRef, type RepoSecrets, type RepoSecretsSync, RepoSettings, type RepoValidationConfig, type RepoVariables, type RequestOptions, type ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, type ResolvedHolocronConfig, type ResolvedProviderEntry, type ResolvedProvidersConfig, type ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, ServerInspection, type SingleEntry, Source, SourceBranch, SourceFile, SourceRepoInfo, SourceRulesetDetail, SourceSecurity, SourceTeamMember, StatusCategory, Storage, StorageBranch, type StorybookDeployProject, type SyncRolesInput, type SyncRolesResult, type TaskEntry, type TaskEntryConfig, TeamEntry, TeamPermission, type TelemetryConfig, type TokenResolver, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, TunnelRoute, Tunnels, Vault, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiProvisionOpts, WikiProxyConfig, WorkerScriptState, Workers, type WorkflowWithConfig, compose, createRestClient, credentialsEnvironment, isMulti, resolveConfig, resolveEntry, resolvePluginPackage };
|
package/dist/index.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CARDINALITY, ElevationRequiredError, MissingTokenError, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, isMulti } from "./plugin/capabilities.mjs";
|
|
2
|
-
import { a as resolveEntry, i as resolveConfig, n as ConfigError, o as resolvePluginPackage, r as credentialsEnvironment, t as compose } from "./compose-
|
|
2
|
+
import { a as resolveEntry, i as resolveConfig, n as ConfigError, o as resolvePluginPackage, r as credentialsEnvironment, t as compose } from "./compose-DU_NeIR0.mjs";
|
|
3
3
|
import { AuthError, createResolveToken as createResolveToken$1, createRestClient } from "@theholocron/http-client";
|
|
4
4
|
import { createEnvLookup, withEnvPrefix } from "@theholocron/env-utils/lookup";
|
|
5
5
|
import { Entry, findCredentials } from "@napi-rs/keyring";
|
package/dist/presets.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { n as Capability, r as ComposedPreset, t as compose } from "./index-
|
|
1
|
+
import { n as Capability, r as ComposedPreset, t as compose } from "./index-CsLdvk4-.mjs";
|
|
2
2
|
/** Options for the audit capability. */
|
|
3
3
|
interface AuditOptions {
|
|
4
4
|
/** Enable Knip unused-export analysis (default: false). */
|
package/dist/presets.mjs
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@theholocron/cli",
|
|
3
|
-
"version": "5.0.0-alpha.
|
|
3
|
+
"version": "5.0.0-alpha.330",
|
|
4
4
|
"description": "The Holocron CLI - a pluggable, capability-based orchestrator for spinning up and operating software projects.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|
|
@@ -53,13 +53,13 @@
|
|
|
53
53
|
"pino-pretty": "^13.1.3",
|
|
54
54
|
"posthog-node": "^5.57.2",
|
|
55
55
|
"yargs": "^18.1.0",
|
|
56
|
-
"@theholocron/astromech": "5.0.0-alpha.
|
|
57
|
-
"@theholocron/datapad": "5.0.0-alpha.329",
|
|
58
|
-
"@theholocron/env-utils": "^1.17.0-alpha.1",
|
|
56
|
+
"@theholocron/astromech": "5.0.0-alpha.330",
|
|
59
57
|
"@theholocron/fs-utils": "^1.17.0-alpha.1",
|
|
60
58
|
"@theholocron/git-utils": "^1.17.0-alpha.1",
|
|
59
|
+
"@theholocron/datapad": "5.0.0-alpha.330",
|
|
61
60
|
"@theholocron/github-client": "^1.58.0-alpha.7",
|
|
62
61
|
"@theholocron/http-client": "^1.58.0-alpha.7",
|
|
62
|
+
"@theholocron/env-utils": "^1.17.0-alpha.1",
|
|
63
63
|
"@theholocron/json-utils": "^1.17.0-alpha.1",
|
|
64
64
|
"@theholocron/misc-utils": "^1.17.0-alpha.1",
|
|
65
65
|
"@theholocron/observability": "^0.7.0-alpha.1",
|
|
@@ -77,10 +77,11 @@
|
|
|
77
77
|
"tsx": "4.23.15",
|
|
78
78
|
"typescript": "^5.9.3",
|
|
79
79
|
"vitest": "^5.0.5",
|
|
80
|
-
"@theholocron/
|
|
80
|
+
"@theholocron/dagobah": "0.0.0",
|
|
81
81
|
"@theholocron/rollup-plugin-transform-template": "^8.9.0-alpha.8",
|
|
82
82
|
"@theholocron/tsconfig": "^8.9.0-alpha.8",
|
|
83
|
-
"@theholocron/vitest-config": "^8.9.0-alpha.8"
|
|
83
|
+
"@theholocron/vitest-config": "^8.9.0-alpha.8",
|
|
84
|
+
"@theholocron/eslint-config": "^8.9.0-alpha.8"
|
|
84
85
|
},
|
|
85
86
|
"engines": {
|
|
86
87
|
"node": ">=22.0.0"
|