@sixthsummit/ship-cli 0.0.0-stage → 1.2.0

package/lib/create.js

@@ -0,0 +1,212 @@
+import { spawnSync } from "node:child_process";
+import { cp, mkdir, readdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+const PROJECT_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+const TEXT_FILE_PATTERN = /(?:^|\/)(?:[^/]+\.(?:json|md|ts)|_gitignore|_gitmessage)$/u;
+export class ScaffoldError extends Error {
+    /** @param {string} message */
+    constructor(message) {
+        super(message);
+        this.name = "ScaffoldError";
+    }
+}
+/**
+ * @typedef {{
+ *   schemaVersion: 1,
+ *   packageManager: string,
+ *   packages: Record<string, string>,
+ *   dependencies: Record<string, string>,
+ *   devDependencies: Record<string, string>
+ * }} ScaffoldReleaseManifest
+ */
+/**
+ * @param {string} manifestPath
+ * @returns {Promise<ScaffoldReleaseManifest>}
+ */
+export async function loadScaffoldReleaseManifest(manifestPath) {
+    let value;
+    try {
+        value = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new ScaffoldError(`could not read the scaffold release manifest at ${manifestPath}: ${errorMessage(error)}`);
+    }
+    if (value?.schemaVersion !== 1 ||
+        typeof value.packageManager !== "string" ||
+        !isStringRecord(value.packages) ||
+        !isStringRecord(value.dependencies) ||
+        !isStringRecord(value.devDependencies)) {
+        throw new ScaffoldError(`invalid scaffold release manifest at ${manifestPath}`);
+    }
+    return value;
+}
+/**
+ * Create the smallest operation-native Ship application.
+ *
+ * @param {{
+ *   projectName: string,
+ *   cwd?: string,
+ *   currentDirectory?: boolean,
+ *   skipInstall?: boolean,
+ *   templateDirectory: string,
+ *   releaseManifest: ScaffoldReleaseManifest,
+ *   install?: (targetDirectory: string) => void,
+ *   spawn?: (command: string, args: string[], options: object) => {
+ *     error?: Error,
+ *     status: number | null
+ *   }
+ * }} options
+ */
+export async function createOperationProject(options) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const currentDirectory = options.currentDirectory === true;
+    if (!currentDirectory && options.projectName === ".") {
+        throw new ScaffoldError("project name `.` requires --current-dir");
+    }
+    const packageName = currentDirectory && options.projectName === "." ? basename(cwd) : options.projectName;
+    validateProjectName(packageName);
+    const targetDirectory = currentDirectory ? cwd : resolve(cwd, options.projectName);
+    const createdTarget = !currentDirectory;
+    await assertWritableTarget(targetDirectory, currentDirectory);
+    try {
+        if (createdTarget)
+            await mkdir(targetDirectory);
+        await cp(options.templateDirectory, targetDirectory, { recursive: true, errorOnExist: true });
+        await renameTemplateDotfiles(targetDirectory);
+        await renderTemplate(targetDirectory, {
+            PROJECT_NAME: displayName(packageName),
+            PACKAGE_NAME: packageName,
+            PACKAGE_MANAGER: options.releaseManifest.packageManager,
+        });
+        await writeGeneratedPackageJson(targetDirectory, packageName, options.releaseManifest);
+        if (!options.skipInstall) {
+            if (options.install)
+                options.install(targetDirectory);
+            else
+                installDependencies(targetDirectory, options.spawn ?? spawnSync);
+        }
+    }
+    catch (error) {
+        if (createdTarget)
+            await rm(targetDirectory, { force: true, recursive: true });
+        if (error instanceof ScaffoldError)
+            throw error;
+        throw new ScaffoldError(`could not create ${packageName}: ${errorMessage(error)}`);
+    }
+    return {
+        packageName,
+        targetDirectory,
+        installed: !options.skipInstall,
+    };
+}
+/** @param {string} projectName */
+function validateProjectName(projectName) {
+    if (!PROJECT_NAME_PATTERN.test(projectName)) {
+        throw new ScaffoldError("project name must be lower-case kebab-case using letters, numbers, and single hyphens");
+    }
+}
+/** @param {string} targetDirectory @param {boolean} currentDirectory */
+async function assertWritableTarget(targetDirectory, currentDirectory) {
+    if (currentDirectory) {
+        const entries = await readdir(targetDirectory);
+        if (entries.length > 0) {
+            throw new ScaffoldError("--current-dir requires an empty directory");
+        }
+        return;
+    }
+    try {
+        await stat(targetDirectory);
+    }
+    catch (error) {
+        if (error && typeof error === "object" && Reflect.get(error, "code") === "ENOENT")
+            return;
+        throw error;
+    }
+    throw new ScaffoldError(`target already exists: ${targetDirectory}`);
+}
+/** @param {string} targetDirectory */
+async function renameTemplateDotfiles(targetDirectory) {
+    await rename(join(targetDirectory, "_gitignore"), join(targetDirectory, ".gitignore"));
+    await rename(join(targetDirectory, "_gitmessage"), join(targetDirectory, ".gitmessage"));
+}
+/** @param {string} targetDirectory @param {Record<string, string>} replacements */
+async function renderTemplate(targetDirectory, replacements) {
+    for (const path of await listFiles(targetDirectory)) {
+        const relativePath = path.slice(targetDirectory.length).replaceAll("\\", "/");
+        if (!TEXT_FILE_PATTERN.test(relativePath))
+            continue;
+        let content = await readFile(path, "utf8");
+        for (const [key, value] of Object.entries(replacements)) {
+            content = content.replaceAll(`{{${key}}}`, value);
+        }
+        await writeFile(path, content);
+    }
+}
+/** @param {string} directory @returns {Promise<string[]>} */
+async function listFiles(directory) {
+    const paths = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        const path = join(directory, entry.name);
+        if (entry.isDirectory())
+            paths.push(...(await listFiles(path)));
+        else if (entry.isFile())
+            paths.push(path);
+    }
+    return paths;
+}
+/**
+ * @param {string} targetDirectory
+ * @param {string} packageName
+ * @param {ScaffoldReleaseManifest} manifest
+ */
+async function writeGeneratedPackageJson(targetDirectory, packageName, manifest) {
+    const sourcePath = join(targetDirectory, "package.template.json");
+    const packageJson = JSON.parse(await readFile(sourcePath, "utf8"));
+    packageJson.name = packageName;
+    packageJson.packageManager = manifest.packageManager;
+    packageJson.dependencies = {
+        ...manifest.packages,
+        ...manifest.dependencies,
+    };
+    packageJson.devDependencies = manifest.devDependencies;
+    await writeFile(join(targetDirectory, "package.json"), `${JSON.stringify(packageJson, null, 2)}\n`);
+    await rm(sourcePath);
+}
+/**
+ * @param {string} targetDirectory
+ * @param {(command: string, args: string[], options: object) => {
+ *   error?: Error,
+ *   status: number | null
+ * }} spawn
+ */
+function installDependencies(targetDirectory, spawn) {
+    const result = spawn("pnpm", ["install"], {
+        cwd: targetDirectory,
+        encoding: "utf8",
+        stdio: "inherit",
+    });
+    if (result.error)
+        throw result.error;
+    if (result.status !== 0) {
+        throw new ScaffoldError(`pnpm install exited with ${result.status ?? "no status"}`);
+    }
+}
+/** @param {string} value */
+function displayName(value) {
+    return value
+        .split("-")
+        .map((part) => `${part[0].toUpperCase()}${part.slice(1)}`)
+        .join(" ");
+}
+/** @param {unknown} value */
+function isStringRecord(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.values(value).every((item) => typeof item === "string"));
+}
+/** @param {unknown} error */
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=create.js.map

package/lib/create.js.map

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

package/lib/forms.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Emit primitive identity-codec bindings from the projected body, never server validators.
+ * @param {import("@sixthsummit/ship-contract").ClientContract} contract
+ * @param {string} operationId
+ * @param {Readonly<Record<string, string | number | boolean | null>>} initialValues
+ * @param {string} [exportName]
+ * @returns {string}
+ */
+export function renderOperationFormBinding(contract: import("@sixthsummit/ship-contract").ClientContract, operationId: string, initialValues: Readonly<Record<string, string | number | boolean | null>>, exportName?: string): string;
+//# sourceMappingURL=forms.d.ts.map

package/lib/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../src/forms.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qDANW,OAAO,4BAA4B,EAAE,cAAc,eACnD,MAAM,iBACN,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,eAC1D,MAAM,GACJ,MAAM,CAkGlB"}

package/lib/forms.js

@@ -0,0 +1,96 @@
+import { compileFunction } from "node:vm";
+/**
+ * Emit primitive identity-codec bindings from the projected body, never server validators.
+ * @param {import("@sixthsummit/ship-contract").ClientContract} contract
+ * @param {string} operationId
+ * @param {Readonly<Record<string, string | number | boolean | null>>} initialValues
+ * @param {string} [exportName]
+ * @returns {string}
+ */
+export function renderOperationFormBinding(contract, operationId, initialValues, exportName = "operationFormBinding") {
+    if (!/^[A-Za-z_$][\w$]*$/u.test(exportName))
+        throw new TypeError("Invalid form export name");
+    try {
+        if (exportName === "await")
+            throw new SyntaxError("Module keyword");
+        compileFunction(`"use strict"; const ${exportName} = null;`);
+    }
+    catch {
+        throw new TypeError("Invalid form export name");
+    }
+    const operation = contract.operations.find((entry) => entry.id === operationId);
+    const schema = operation?.input.body?.jsonSchema;
+    if (!schema || schema.type !== "object" || !schema.properties)
+        throw new TypeError("Form projection requires an object body");
+    const composition = [
+        "allOf",
+        "anyOf",
+        "oneOf",
+        "not",
+        "if",
+        "then",
+        "else",
+        "$ref",
+        "$dynamicRef",
+        "dependentSchemas",
+        "dependentRequired",
+    ];
+    if (composition.some((key) => Object.hasOwn(schema, key)))
+        throw new TypeError("Unsupported composed form body");
+    const fields = Object.entries(schema.properties).map(([name, property]) => {
+        if (property.anyOf && Object.hasOwn(property, "type"))
+            throw new TypeError(`Unsupported intersected form field: ${name}`);
+        if (composition.some((key) => key !== "anyOf" && Object.hasOwn(property, key)))
+            throw new TypeError(`Unsupported form field: ${name}`);
+        const nullBranch = property.anyOf?.find((entry) => entry.type === "null");
+        if (nullBranch &&
+            Object.keys(nullBranch).some((key) => !["type", "title", "description"].includes(key)))
+            throw new TypeError(`Unsupported null form branch: ${name}`);
+        if (["__proto__", "constructor", "prototype"].includes(name))
+            throw new TypeError(`Unsupported form field name: ${name}`);
+        if (property.enum ||
+            property.const !== undefined ||
+            property.allOf ||
+            property.oneOf ||
+            (property.anyOf &&
+                (property.anyOf.length !== 2 || !property.anyOf.some((entry) => entry.type === "null"))) ||
+            (Array.isArray(property.type) &&
+                (property.type.length !== 2 || !property.type.includes("null"))))
+            throw new TypeError(`Unsupported form field: ${name}`);
+        const nullable = property.anyOf?.find((entry) => entry.type === "null") ||
+            (Array.isArray(property.type) && property.type.includes("null"));
+        const valueSchema = property.anyOf
+            ? property.anyOf.find((entry) => entry.type !== "null")
+            : Array.isArray(property.type)
+                ? { ...property, type: property.type.find((type) => type !== "null") }
+                : property;
+        if (!valueSchema || !["string", "number", "integer", "boolean"].includes(valueSchema.type))
+            throw new TypeError(`Unsupported form field: ${name}`);
+        if (valueSchema.enum || valueSchema.const !== undefined)
+            throw new TypeError(`Unsupported form field: ${name}`);
+        if (composition.some((key) => Object.hasOwn(valueSchema, key)))
+            throw new TypeError(`Unsupported form field: ${name}`);
+        if (!Object.hasOwn(initialValues, name))
+            throw new TypeError(`Explicit initial value required: ${name}`);
+        const initial = initialValues[name];
+        const type = valueSchema.type === "integer" ? "number" : valueSchema.type;
+        if (typeof initial === "number" &&
+            (!Number.isFinite(initial) || (valueSchema.type === "integer" && !Number.isInteger(initial))))
+            throw new TypeError(`Invalid numeric initial value: ${name}`);
+        if (!(initial === null && nullable) && typeof initial !== type)
+            throw new TypeError(`Invalid initial value: ${name}`);
+        const tsType = `${type}${nullable ? " | null" : ""}`;
+        const optional = !(schema.required ?? []).includes(name);
+        const state = optional
+            ? { kind: "omitted", controlValue: initial }
+            : { kind: "value", value: initial };
+        const checks = [];
+        if (type === "string" && valueSchema.minLength !== undefined)
+            checks.push(`if (value !== null && value.length < ${Number(valueSchema.minLength)}) return [{path:[${JSON.stringify(name)}],code:"min_length",message:"Value is too short"}];`);
+        return `${JSON.stringify(name)}: { optional: ${optional}, initial: ${JSON.stringify(state)}, codec: { encode: (value: ${tsType}): ${tsType} => value, decode: (value: ${tsType}): ${tsType} => value }, validate: (value: ${tsType}) => { ${checks.join(" ")} return []; } }`;
+    });
+    if (Object.keys(initialValues).some((name) => !(name in schema.properties)))
+        throw new TypeError("Unknown initial field");
+    return `export const ${exportName} = { operation: ${JSON.stringify(operationId)}, fields: {${fields.join(",\n")}} } as const;\n`;
+}
+//# sourceMappingURL=forms.js.map

package/lib/forms.js.map

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

package/lib/graph.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @param {GraphCliOptions} [options]
+ * @returns {Promise<LoadedApplication>}
+ */
+export function loadApplication(options?: GraphCliOptions): Promise<LoadedApplication>;
+/**
+ * @param {GraphCliOptions} [options]
+ * @returns {Promise<Readonly<{command: "check", ok: true, graph: ApplicationGraph, emitted?: string}>>}
+ */
+export function checkApplication(options?: GraphCliOptions): Promise<Readonly<{
+    command: "check";
+    ok: true;
+    graph: ApplicationGraph;
+    emitted?: string;
+}>>;
+/**
+ * @param {GraphKind} kind
+ * @param {string | undefined} id
+ * @param {GraphCliOptions} [options]
+ * @returns {Promise<Readonly<{command: "inspect", ok: true, kind: GraphKind, id: string, node: GraphNode}>>}
+ */
+export function inspectApplication(kind: GraphKind, id: string | undefined, options?: GraphCliOptions): Promise<Readonly<{
+    command: "inspect";
+    ok: true;
+    kind: GraphKind;
+    id: string;
+    node: GraphNode;
+}>>;
+/**
+ * @param {GraphKind} kind
+ * @param {string | undefined} id
+ * @param {GraphCliOptions} [options]
+ * @returns {Promise<Readonly<{command: "affected", ok: true, kind: GraphKind, id: string, affected: AffectedGraphSurface}>>}
+ */
+export function affectedApplication(kind: GraphKind, id: string | undefined, options?: GraphCliOptions): Promise<Readonly<{
+    command: "affected";
+    ok: true;
+    kind: GraphKind;
+    id: string;
+    affected: AffectedGraphSurface;
+}>>;
+/**
+ * @param {() => Promise<unknown>} command
+ * @param {{format?: GraphOutputFormat}} [options]
+ * @param {GraphIo} [io]
+ * @returns {Promise<GraphCliExitCode>}
+ */
+export function runGraphCommand(command: () => Promise<unknown>, options?: {
+    format?: GraphOutputFormat;
+}, io?: GraphIo): Promise<GraphCliExitCode>;
+/** @typedef {import("@sixthsummit/ship-core").AnyModule} AnyModule */
+/** @typedef {import("@sixthsummit/ship-core").ApplicationGraph} ApplicationGraph */
+/** @typedef {import("@sixthsummit/ship-core").CompiledApplication<string, readonly AnyModule[]>} LoadedApplication */
+/** @typedef {import("@sixthsummit/ship-core").ModuleGraphNode | import("@sixthsummit/ship-core").OperationGraphNode | import("@sixthsummit/ship-core").ProviderGraphNode | import("@sixthsummit/ship-core").ChannelGraphNode | import("@sixthsummit/ship-core").JobGraphNode | ApplicationGraph} GraphNode */
+/** @typedef {"human" | "json"} GraphOutputFormat */
+/** @typedef {"app" | "module" | "operation" | "provider" | "channel" | "job"} GraphKind */
+/** @typedef {0 | 1 | 2} GraphCliExitCode */
+/**
+ * @typedef {object} GraphCliDiagnostic
+ * @property {string} code
+ * @property {"error" | "warning"} severity
+ * @property {string} message
+ * @property {string} hint
+ * @property {string=} appId
+ * @property {string=} moduleId
+ * @property {string=} operationId
+ * @property {string=} providerId
+ * @property {string=} path
+ */
+/**
+ * @typedef {object} GraphCliOptions
+ * @property {string=} cwd
+ * @property {string=} appPath
+ * @property {string=} emit
+ * @property {GraphOutputFormat=} format
+ */
+/**
+ * @typedef {object} AffectedGraphSurface
+ * @property {readonly string[]} modules
+ * @property {readonly string[]} operations
+ * @property {readonly string[]} providers
+ */
+/**
+ * @typedef {object} GraphIo
+ * @property {(value: string) => unknown} stdout
+ * @property {(value: string) => unknown} stderr
+ */
+export const GRAPH_CLI_EXIT: Readonly<{
+    success: 0;
+    applicationInvalid: 1;
+    usageOrLoadError: 2;
+}>;
+export class GraphCliError extends Error {
+    /**
+     * @param {readonly GraphCliDiagnostic[]} diagnostics
+     * @param {GraphCliExitCode} [exitCode]
+     * @param {ErrorOptions} [options]
+     */
+    constructor(diagnostics: readonly GraphCliDiagnostic[], exitCode?: GraphCliExitCode, options?: ErrorOptions);
+    diagnostics: readonly Readonly<{
+        code: string;
+        severity: "error" | "warning";
+        message: string;
+        hint: string;
+        appId?: string | undefined;
+        moduleId?: string | undefined;
+        operationId?: string | undefined;
+        providerId?: string | undefined;
+        path?: string | undefined;
+    }>[];
+    exitCode: GraphCliExitCode;
+}
+export const __test: Readonly<{
+    affectedByModule: typeof affectedByModule;
+    affectedByOperation: typeof affectedByOperation;
+    affectedByProvider: typeof affectedByProvider;
+    normalizeGraphError: typeof normalizeGraphError;
+    projectPermissions: typeof projectPermissions;
+    renderFailure: typeof renderFailure;
+    renderSuccess: typeof renderSuccess;
+}>;
+export type AnyModule = import("@sixthsummit/ship-core").AnyModule;
+export type ApplicationGraph = import("@sixthsummit/ship-core").ApplicationGraph;
+export type LoadedApplication = import("@sixthsummit/ship-core").CompiledApplication<string, readonly AnyModule[]>;
+export type GraphNode = import("@sixthsummit/ship-core").ModuleGraphNode | import("@sixthsummit/ship-core").OperationGraphNode | import("@sixthsummit/ship-core").ProviderGraphNode | import("@sixthsummit/ship-core").ChannelGraphNode | import("@sixthsummit/ship-core").JobGraphNode | ApplicationGraph;
+export type GraphOutputFormat = "human" | "json";
+export type GraphKind = "app" | "module" | "operation" | "provider" | "channel" | "job";
+export type GraphCliExitCode = 0 | 1 | 2;
+export type GraphCliDiagnostic = {
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+    hint: string;
+    appId?: string | undefined;
+    moduleId?: string | undefined;
+    operationId?: string | undefined;
+    providerId?: string | undefined;
+    path?: string | undefined;
+};
+export type GraphCliOptions = {
+    cwd?: string | undefined;
+    appPath?: string | undefined;
+    emit?: string | undefined;
+    format?: GraphOutputFormat | undefined;
+};
+export type AffectedGraphSurface = {
+    modules: readonly string[];
+    operations: readonly string[];
+    providers: readonly string[];
+};
+export type GraphIo = {
+    stdout: (value: string) => unknown;
+    stderr: (value: string) => unknown;
+};
+declare function affectedByModule(graph: any, id: any): Readonly<{
+    modules: readonly any[];
+    operations: readonly any[];
+    providers: readonly any[];
+}>;
+/**
+ * An operation affects itself, and a write affects every cached read it
+ * invalidates: the declared tags are real graph edges, so a change to an
+ * invalidating write reaches the reads whose entries it purges.
+ */
+declare function affectedByOperation(graph: any, operation: any): Readonly<{
+    modules: readonly any[];
+    operations: readonly any[];
+    providers: readonly any[];
+}>;
+declare function affectedByProvider(graph: any, id: any): Readonly<{
+    modules: readonly any[];
+    operations: readonly any[];
+    providers: readonly any[];
+}>;
+declare function normalizeGraphError(cause: any): GraphCliError;
+/**
+ * Every permission slug an app or module's operations (and HTTP job triggers)
+ * demand, with the operations that demand it. A slug under `ship.` is
+ * introduced by a framework module (`ship.outbox:manage`, `ship.jobs:manage`,
+ * `ship.webhooks:replay`) and must be granted by the consumer's own
+ * authorization model before those operations can be reached.
+ *
+ * @param {ApplicationGraph} graph
+ * @param {string | undefined} moduleId
+ * @returns {readonly Readonly<{permission: string, framework: boolean, operations: readonly string[]}>[]}
+ */
+declare function projectPermissions(graph: ApplicationGraph, moduleId: string | undefined): readonly Readonly<{
+    permission: string;
+    framework: boolean;
+    operations: readonly string[];
+}>[];
+declare function renderFailure(error: any, format: any): any;
+declare function renderSuccess(result: any, format: any): string;
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/lib/graph.d.ts.map

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