silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/command-message/runtime.js

@@ -0,0 +1,215 @@
+import { buildReport, clone, completionFactType, deepFreeze, DOMAIN_MESSAGE_SCHEMA_VERSION, DomainInvariantError, initialInternalObservation, reduceObservation, responseMetadata, } from "./observation.js";
+import { emitDomainMessage, traceAsync } from "../trace/index.js";
+export function createCommandRun(intention, { eventSink = emitDomainMessage, dispatch, onReady, } = {}) {
+    const events = [];
+    let nextActionId = 1;
+    let state = initialInternalObservation();
+    function emit(message) {
+        const event = deepFreeze({
+            schemaVersion: DOMAIN_MESSAGE_SCHEMA_VERSION,
+            sequence: events.length + 1,
+            ...clone(message),
+        });
+        state = reduceObservation(state, event);
+        events.push(event);
+        run.eventSink(event);
+        return event;
+    }
+    const run = {
+        eventSink,
+        get events() {
+            return events.map((event) => clone(event));
+        },
+        get observation() {
+            return state;
+        },
+        observe(observation, { factType = "command.observation", progress = "observing", responseContext = {}, } = {}) {
+            return emit({
+                type: "observation.fact",
+                fact: {
+                    type: factType,
+                    observation,
+                    progress,
+                    responseContext,
+                },
+            });
+        },
+        requestAction(action) {
+            if (!action || typeof action.type !== "string" || action.type.length === 0) {
+                throw new DomainInvariantError("An action requires a non-empty type");
+            }
+            const actionId = `action-${nextActionId}`;
+            nextActionId += 1;
+            emit({
+                type: "action.requested",
+                actionId,
+                action,
+            });
+            return actionId;
+        },
+        finishAction(actionId, actionType, completion) {
+            if (completion.status === "success") {
+                return emit({
+                    type: "action.finished",
+                    actionId,
+                    actionType,
+                    status: "success",
+                    result: completion.result,
+                    facts: completion.facts ?? [],
+                });
+            }
+            return emit({
+                type: "action.finished",
+                actionId,
+                actionType,
+                status: "failure",
+                problem: completion.problem,
+                facts: completion.facts ?? [],
+            });
+        },
+        async performAction(action, execute, mapError, mapSuccess) {
+            const actionId = commands.requestAction(action);
+            const operation = async () => {
+                try {
+                    const executed = await execute({ actionId });
+                    const mapped = mapSuccess?.(executed);
+                    const completion = {
+                        status: "success",
+                        result: mapped?.result ?? executed,
+                        facts: mapped?.facts ?? [],
+                    };
+                    commands.finishAction(actionId, action.type, completion);
+                    return completion;
+                }
+                catch (caught) {
+                    const mapped = mapError?.(caught);
+                    const completion = {
+                        status: "failure",
+                        problem: mapped?.problem ?? {
+                            type: "unexpected-action-failure",
+                            summary: caught instanceof Error ? caught.name : typeof caught,
+                        },
+                        facts: mapped?.facts ?? [],
+                        ...(mapped?.internal === undefined
+                            ? {}
+                            : { internal: mapped.internal }),
+                    };
+                    commands.finishAction(actionId, action.type, completion);
+                    if (mapped === undefined)
+                        throw caught;
+                    return completion;
+                }
+            };
+            return traceAsync(`action.${action.type}`, { actionId, actionType: action.type }, operation, (completion) => ({
+                status: completion.status === "success" ? "ok" : "error",
+            }));
+        },
+        finish() {
+            const report = buildReport(events, { requireResponse: false });
+            emit({
+                type: "response.created",
+                kind: report.response.kind,
+                metadata: responseMetadata(report.response),
+            });
+            return buildReport(events);
+        },
+        complete(observation, responseContext = {}, { factType } = {}) {
+            const progress = observation.problems.length > 0 ? "blocked" : "ready";
+            const acceptedIntention = state.intention;
+            if (acceptedIntention === null) {
+                throw new DomainInvariantError("Cannot complete a command before accepting its intention");
+            }
+            commands.observe(observation, {
+                factType: factType
+                    ?? completionFactType(acceptedIntention, observation),
+                progress,
+                responseContext,
+            });
+            return commands.finish();
+        },
+    };
+    const commands = dispatch ?? run;
+    onReady?.(run);
+    emit({ type: "intention.accepted", intention });
+    return run;
+}
+export class CommandRun {
+    #run;
+    eventSink;
+    constructor(intention, { eventSink = emitDomainMessage } = {}) {
+        this.eventSink = eventSink;
+        this.#run = createCommandRun(intention, {
+            eventSink: (event) => this.eventSink(event),
+            dispatch: this,
+            onReady: (run) => {
+                this.#run = run;
+            },
+        });
+    }
+    #getRun() {
+        if (this.#run === undefined) {
+            throw new DomainInvariantError("Command run is not initialized");
+        }
+        return this.#run;
+    }
+    get events() {
+        return this.#getRun().events;
+    }
+    get observation() {
+        return this.#getRun().observation;
+    }
+    observe(observation, options = {}) {
+        return this.#getRun().observe(observation, options);
+    }
+    requestAction(action) {
+        return this.#getRun().requestAction(action);
+    }
+    finishAction(actionId, actionType, completion) {
+        return this.#getRun().finishAction(actionId, actionType, completion);
+    }
+    performAction(action, execute, mapError, mapSuccess) {
+        return this.#getRun().performAction(action, execute, mapError, mapSuccess);
+    }
+    finish() {
+        return this.#getRun().finish();
+    }
+    complete(observation, responseContext = {}, options = {}) {
+        return this.#getRun().complete(observation, responseContext, options);
+    }
+}
+export async function driveCommand({ decide, intention, ports, responseContext = {}, }) {
+    const run = createCommandRun(intention);
+    for (let step = 0; step < 100; step += 1) {
+        const decision = decide(intention, run.observation);
+        if (decision.type === "response") {
+            if (decision.observation === undefined
+                && (run.observation.progress === "ready"
+                    || run.observation.progress === "blocked")) {
+                return run.finish();
+            }
+            const observation = decision.observation ?? run.observation.observation;
+            if (observation === null) {
+                throw new DomainInvariantError("A response decision requires an observation");
+            }
+            return run.complete(observation, decision.responseContext ?? responseContext);
+        }
+        if (decision.type === "probe") {
+            const observed = await ports.probe(decision.effect);
+            run.observe(observed.observation, {
+                factType: observed.factType ?? decision.factType ?? "command.probe",
+                progress: observed.progress ?? "observing",
+                responseContext: observed.responseContext ?? {},
+            });
+            continue;
+        }
+        if (decision.type === "action") {
+            await run.performAction(decision.effect, ({ actionId }) => ports.action(decision.effect, { actionId }), decision.mapError, (completed) => ({
+                result: completed.result ?? completed,
+                facts: completed.facts ?? [],
+            }));
+            continue;
+        }
+    }
+    throw new DomainInvariantError("Command driver exceeded 100 decisions");
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/foundation/command-message/runtime.js.map

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

package/dist/src/foundation/coordinates/index.d.ts

@@ -0,0 +1,3 @@
+export { CONFIG_PATH, GUIDANCE_PHASES, GUIDANCE_ROOT, IDEAS_ROOT, METADATA_ROOT, PHASE_GUIDANCE_PATHS, ideaPaths, phaseGuidancePath, } from "./layout.ts";
+export { canonicalRepository, effectiveSourceRepository, repositoryNamespace, validBranchName, validRepository, } from "./repository.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/coordinates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/coordinates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/src/foundation/coordinates/index.js

@@ -0,0 +1,3 @@
+export { CONFIG_PATH, GUIDANCE_PHASES, GUIDANCE_ROOT, IDEAS_ROOT, METADATA_ROOT, PHASE_GUIDANCE_PATHS, ideaPaths, phaseGuidancePath, } from "./layout.js";
+export { canonicalRepository, effectiveSourceRepository, repositoryNamespace, validBranchName, validRepository, } from "./repository.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/coordinates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/coordinates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/src/foundation/coordinates/layout.d.ts

@@ -0,0 +1,27 @@
+export declare const METADATA_ROOT = ".silvermoon";
+export declare const CONFIG_PATH = ".silvermoon/config.yaml";
+export declare const IDEAS_ROOT = ".silvermoon/ideas";
+export declare const GUIDANCE_ROOT = ".silvermoon/guidance";
+export declare const PHASE_GUIDANCE_PATHS: Readonly<{
+    preparing: ".silvermoon/guidance/preparing.md";
+    implementing: ".silvermoon/guidance/implementing.md";
+    deploying: ".silvermoon/guidance/deploying.md";
+}>;
+export declare const GUIDANCE_PHASES: readonly string[];
+export type GuidancePhase = keyof typeof PHASE_GUIDANCE_PATHS;
+/** @pure */
+export declare function phaseGuidancePath(phase: string | undefined): ".silvermoon/guidance/preparing.md" | ".silvermoon/guidance/implementing.md" | ".silvermoon/guidance/deploying.md";
+/** @pure */
+export declare function ideaPaths(id: string): {
+    ideaPath: string;
+    statusPath: string;
+    eventsPath: string;
+    ledgerPath: string;
+    outerPath: string;
+    deploymentDocumentPath: string;
+    innerPath: string;
+    implementationDocumentPath: string;
+    idealPath: string;
+    ideaDocumentPath: string;
+};
+//# sourceMappingURL=layout.d.ts.map

package/dist/src/foundation/coordinates/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../src/foundation/coordinates/layout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAC3C,eAAO,MAAM,WAAW,4BAAiC,CAAC;AAC1D,eAAO,MAAM,UAAU,sBAA2B,CAAC;AACnD,eAAO,MAAM,aAAa,yBAA8B,CAAC;AACzD,eAAO,MAAM,oBAAoB;;;;EAI/B,CAAC;AACH,eAAO,MAAM,eAAe,mBAE3B,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAO9D,YAAY;AACZ,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,sHAK1D;AAED,YAAY;AACZ,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;EAiBnC"}

package/dist/src/foundation/coordinates/layout.js

@@ -0,0 +1,41 @@
+export const METADATA_ROOT = ".silvermoon";
+export const CONFIG_PATH = `${METADATA_ROOT}/config.yaml`;
+export const IDEAS_ROOT = `${METADATA_ROOT}/ideas`;
+export const GUIDANCE_ROOT = `${METADATA_ROOT}/guidance`;
+export const PHASE_GUIDANCE_PATHS = Object.freeze({
+    preparing: `${GUIDANCE_ROOT}/preparing.md`,
+    implementing: `${GUIDANCE_ROOT}/implementing.md`,
+    deploying: `${GUIDANCE_ROOT}/deploying.md`,
+});
+export const GUIDANCE_PHASES = Object.freeze(Object.keys(PHASE_GUIDANCE_PATHS));
+/** @pure */
+function isGuidancePhase(phase) {
+    return Object.hasOwn(PHASE_GUIDANCE_PATHS, phase);
+}
+/** @pure */
+export function phaseGuidancePath(phase) {
+    if (phase === undefined || !isGuidancePhase(phase)) {
+        throw new TypeError(`Unsupported guidance phase: ${String(phase)}`);
+    }
+    return PHASE_GUIDANCE_PATHS[phase];
+}
+/** @pure */
+export function ideaPaths(id) {
+    const ideaPath = `${IDEAS_ROOT}/${id}`;
+    const outerPath = `${ideaPath}/outer`;
+    const innerPath = `${outerPath}/inner`;
+    const idealPath = `${innerPath}/ideal`;
+    return {
+        ideaPath,
+        statusPath: `${ideaPath}/status.yaml`,
+        eventsPath: `${ideaPath}/events.jsonl`,
+        ledgerPath: `${ideaPath}/ledger.md`,
+        outerPath,
+        deploymentDocumentPath: `${outerPath}/Deployment.md`,
+        innerPath,
+        implementationDocumentPath: `${innerPath}/Implementation.md`,
+        idealPath,
+        ideaDocumentPath: `${idealPath}/Idea.md`,
+    };
+}
+//# sourceMappingURL=layout.js.map

package/dist/src/foundation/coordinates/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../src/foundation/coordinates/layout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,aAAa,cAAc,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,aAAa,QAAQ,CAAC;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,aAAa,WAAW,CAAC;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,GAAG,aAAa,eAAe;IAC1C,YAAY,EAAE,GAAG,aAAa,kBAAkB;IAChD,SAAS,EAAE,GAAG,aAAa,eAAe;CAC3C,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAC1C,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAClC,CAAC;AAGF,YAAY;AACZ,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,QAAQ,QAAQ,CAAC;IACtC,MAAM,SAAS,GAAG,GAAG,SAAS,QAAQ,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,SAAS,QAAQ,CAAC;IACvC,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,GAAG,QAAQ,cAAc;QACrC,UAAU,EAAE,GAAG,QAAQ,eAAe;QACtC,UAAU,EAAE,GAAG,QAAQ,YAAY;QACnC,SAAS;QACT,sBAAsB,EAAE,GAAG,SAAS,gBAAgB;QACpD,SAAS;QACT,0BAA0B,EAAE,GAAG,SAAS,oBAAoB;QAC5D,SAAS;QACT,gBAAgB,EAAE,GAAG,SAAS,UAAU;KACzC,CAAC;AACJ,CAAC"}

package/dist/src/foundation/coordinates/repository.d.ts

@@ -0,0 +1,16 @@
+import { URL } from "node:url";
+/** @pure */
+export declare function canonicalRepository(value: string | string[] | URL): string | null;
+/** @pure */
+export declare function validRepository(value: string): boolean;
+/** @pure */
+export declare function repositoryNamespace(value: string | string[] | URL): string;
+/** @pure */
+export declare function validBranchName(value: {} | null | undefined): boolean;
+/** @pure */
+export declare function effectiveSourceRepository(config: {
+    primaryRepository: unknown;
+}, record: {
+    sourceRepository: unknown;
+}): unknown;
+//# sourceMappingURL=repository.d.ts.map

package/dist/src/foundation/coordinates/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/foundation/coordinates/repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAO/B,YAAY;AACZ,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,EAAE,GAAC,GAAG,iBAmC7D;AAED,YAAY;AACZ,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,WAE5C;AAED,YAAY;AACZ,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,EAAE,GAAC,GAAG,UAI7D;AAED,YAAY;AACZ,wBAAgB,eAAe,CAAC,KAAK,EAAE,EAAE,GAAC,IAAI,GAAC,SAAS,WAuBvD;AAED,YAAY;AACZ,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,iBAAiB,EAAE,OAAO,CAAC;CAAE,EAAE,MAAM,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAC;CAAE,WAExH"}

package/dist/src/foundation/coordinates/repository.js

@@ -0,0 +1,75 @@
+import { createHash } from "node:crypto";
+import { URL } from "node:url";
+const CONTROL_CHARACTER = /[\u0000-\u001f\u007f]/;
+const ENCODED_SEPARATOR = /%(?:2f|5c)/i;
+const CANONICAL_HOST = /^(?:[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?|\[[0-9a-f:.]+\])$/;
+const INVALID_BRANCH_CHARACTER = /[\u0000-\u0020\u007f~^:?*\[\\]/;
+/** @pure */
+export function canonicalRepository(value) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        CONTROL_CHARACTER.test(value) ||
+        value.includes("\\")) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.protocol !== "https:" ||
+        !parsed.hostname ||
+        !CANONICAL_HOST.test(parsed.hostname) ||
+        parsed.username ||
+        parsed.password ||
+        parsed.search ||
+        parsed.hash ||
+        parsed.pathname === "/" ||
+        parsed.pathname.endsWith("/") ||
+        parsed.pathname.includes("//") ||
+        ENCODED_SEPARATOR.test(parsed.pathname) ||
+        parsed.href !== value) {
+        return null;
+    }
+    return parsed.href;
+}
+/** @pure */
+export function validRepository(value) {
+    return canonicalRepository(value) !== null;
+}
+/** @pure */
+export function repositoryNamespace(value) {
+    const canonical = canonicalRepository(value);
+    if (!canonical)
+        throw new Error(`Invalid repository URL: ${String(value)}`);
+    return createHash("sha256").update(canonical).digest("hex");
+}
+/** @pure */
+export function validBranchName(value) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value === "@" ||
+        value === "HEAD" ||
+        value.startsWith("-") ||
+        value.startsWith("refs/") ||
+        value.startsWith("remotes/") ||
+        value.endsWith("/") ||
+        value.endsWith(".") ||
+        value.includes("//") ||
+        value.includes("..") ||
+        value.includes("@{") ||
+        INVALID_BRANCH_CHARACTER.test(value)) {
+        return false;
+    }
+    const structurallyValid = value
+        .split("/")
+        .every((component) => component && !component.startsWith(".") && !component.endsWith(".lock"));
+    return structurallyValid;
+}
+/** @pure */
+export function effectiveSourceRepository(config, record) {
+    return record.sourceRepository ?? config.primaryRepository;
+}
+//# sourceMappingURL=repository.js.map

package/dist/src/foundation/coordinates/repository.js.map

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

package/dist/src/foundation/device-config/index.d.ts

@@ -0,0 +1,2 @@
+export { USER_CONFIG_PATH, loadUserConfig, serializeUserConfig, } from "./user-config.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/device-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/device-config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/src/foundation/device-config/index.js

@@ -0,0 +1,2 @@
+export { USER_CONFIG_PATH, loadUserConfig, serializeUserConfig, } from "./user-config.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/device-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/device-config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/src/foundation/device-config/user-config.d.ts

@@ -0,0 +1,19 @@
+export declare const USER_CONFIG_PATH = ".config/silvermoon/config.yaml";
+declare function serializeUserConfig(config: {
+    preferredLanguage?: unknown;
+}): string;
+export declare function loadUserConfig({ home }?: {
+    home?: string | undefined;
+}): Promise<{
+    config: any;
+    configPath: string;
+    diagnostics: {
+        code: string;
+        level: string;
+        path: string;
+        message: string;
+        remediation: string;
+    }[];
+}>;
+export { serializeUserConfig };
+//# sourceMappingURL=user-config.d.ts.map

package/dist/src/foundation/device-config/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../../../../src/foundation/device-config/user-config.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAkBjE,iBAAS,mBAAmB,CAAC,MAAM,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,UAMnE;AAED,wBAAsB,cAAc,CAAC,EAAE,IAAgB,EAAE;;CAAK;;;;;;;;;;GA6G7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/foundation/device-config/user-config.js

@@ -0,0 +1,94 @@
+import { lstat, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { isCanonicalLanguageTag } from "../language/index.js";
+import { parseStrictYaml, stringifyCanonicalYaml } from "../schema/index.js";
+export const USER_CONFIG_PATH = ".config/silvermoon/config.yaml";
+const USER_CONFIG_KEYS = new Set(["version", "preferredLanguage"]);
+function errorCode(caught) {
+    return caught instanceof Error && "code" in caught && typeof caught.code === "string"
+        ? caught.code
+        : undefined;
+}
+function errorMessage(caught) {
+    return caught instanceof Error ? caught.message : String(caught);
+}
+function diagnostic(code, path, message, remediation) {
+    return { code, level: "error", path, message, remediation };
+}
+function serializeUserConfig(config) {
+    const canonical = { version: 1 };
+    if (config.preferredLanguage !== undefined) {
+        canonical.preferredLanguage = config.preferredLanguage;
+    }
+    return stringifyCanonicalYaml(canonical);
+}
+export async function loadUserConfig({ home = homedir() } = {}) {
+    const configPath = resolve(home, USER_CONFIG_PATH);
+    let metadata;
+    let source;
+    try {
+        metadata = await lstat(configPath);
+        if (!metadata.isFile() || metadata.isSymbolicLink()) {
+            throw Object.assign(new Error("User configuration must be a regular file"), {
+                code: "EINVAL",
+            });
+        }
+        source = await readFile(configPath, "utf8");
+    }
+    catch (caught) {
+        if (errorCode(caught) === "ENOENT") {
+            return { config: null, configPath, diagnostics: [] };
+        }
+        return {
+            config: null,
+            configPath,
+            diagnostics: [diagnostic("user-config.invalid-file", configPath, `Cannot read Silvermoon user configuration: ${errorMessage(caught)}`, `Replace ${configPath} with a readable regular file or remove it.`)],
+        };
+    }
+    const normalizedSource = source.replaceAll("\r\n", "\n");
+    let value;
+    try {
+        value = parseStrictYaml(normalizedSource);
+    }
+    catch (caught) {
+        return {
+            config: null,
+            configPath,
+            diagnostics: [diagnostic("user-config.invalid-yaml", configPath, `Cannot parse Silvermoon user configuration: ${errorMessage(caught)}`, `Use the strict YAML contract in ${configPath}.`)],
+        };
+    }
+    if (value === null || Array.isArray(value) || typeof value !== "object") {
+        return {
+            config: null,
+            configPath,
+            diagnostics: [diagnostic("user-config.invalid-type", configPath, "The Silvermoon user configuration must be a YAML mapping.", `Replace ${configPath} with the documented mapping.`)],
+        };
+    }
+    const diagnostics = [];
+    for (const key of Object.keys(value).sort()) {
+        if (!USER_CONFIG_KEYS.has(key)) {
+            diagnostics.push(diagnostic("user-config.unknown-key", `${configPath}#${key}`, `Unknown Silvermoon user configuration key: ${key}`, `Remove ${key}.`));
+        }
+    }
+    if (!Object.hasOwn(value, "version")) {
+        diagnostics.push(diagnostic("user-config.missing-version", `${configPath}#version`, "Missing required key: version", `Add version: 1 to ${configPath}.`));
+    }
+    else if (value.version !== 1) {
+        diagnostics.push(diagnostic("user-config.unsupported-version", `${configPath}#version`, `Unsupported Silvermoon user configuration version: ${String(value.version)}`, "Use version: 1."));
+    }
+    if (Object.hasOwn(value, "preferredLanguage") &&
+        !isCanonicalLanguageTag(value.preferredLanguage)) {
+        diagnostics.push(diagnostic("user-config.invalid-preferred-language", `${configPath}#preferredLanguage`, "preferredLanguage must be a canonical BCP 47 language tag.", "Use a canonical tag such as en or zh-CN."));
+    }
+    if (diagnostics.length === 0 && serializeUserConfig(value) !== normalizedSource) {
+        diagnostics.push(diagnostic("user-config.noncanonical", configPath, "The Silvermoon user configuration is valid but not canonical.", "Rewrite properties in version, preferredLanguage order with LF endings."));
+    }
+    return {
+        config: diagnostics.length === 0 ? value : null,
+        configPath,
+        diagnostics,
+    };
+}
+export { serializeUserConfig };
+//# sourceMappingURL=user-config.js.map

package/dist/src/foundation/device-config/user-config.js.map

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