@aotter/mantle 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/codegen/emitMantleModule.js

@@ -0,0 +1,217 @@
+import { EmitTypesUseCase, manifestTypeIdentifier, validateDiagnostic, } from "@aotter/mantle-spec";
+import { compileRuntimePlan } from "@aotter/mantle-runtime";
+const GENERATED_NAMES = new Set([
+    "BootMantleRuntimeArgs",
+    "CoreMantleRuntime",
+    "CreateMantleOptions",
+    "RuntimePlanData",
+    "MantleHandlers",
+    "MantleViewOptions",
+    "RuntimeHandlerContext",
+    "RuntimeHandlerFn",
+    "bindMantle",
+    "bootMantleRuntime",
+    "createMantle",
+    "plan",
+    "sealRuntimePlan",
+]);
+export function assertMantleNamespace(namespace, label = "namespace") {
+    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(namespace) || GENERATED_NAMES.has(namespace)) {
+        throw new Error(`${label} must be a non-reserved TypeScript identifier; got ${JSON.stringify(namespace)}`);
+    }
+}
+/** Pure TypeScript projection of one linked and compiled Mantle revision. */
+export function emitMantleModule(request) {
+    const namespace = request.namespace ?? "Mantle";
+    assertMantleNamespace(namespace);
+    const collision = findIdentifierCollision(request.linked);
+    if (collision)
+        return { ok: false, diagnostics: [collision] };
+    const compiled = compileRuntimePlan(request.linked);
+    if (!compiled.ok)
+        return { ok: false, diagnostics: compiled.diagnostics };
+    const plan = compiled.value;
+    const schemas = sortedValues(plan.schemas);
+    const views = sortedValues(plan.views);
+    const procedures = sortedValues(plan.procedures);
+    const triggers = sortedValues(plan.triggers);
+    const generatedTypes = EmitTypesUseCase.run({ linked: request.linked, namespace }).source
+        .replace(/^\/\/ Generated by `mantle-spec emit-types`\. Do not edit by hand\.\n\n/, "")
+        .trimEnd();
+    const handlerTypes = handlerContractLines(procedures, namespace);
+    return {
+        ok: true,
+        source: [
+            "// Generated by `mantle generate`. Do not edit by hand.",
+            "import { bootMantleRuntime, sealRuntimePlan } from \"@aotter/mantle/runtime\";",
+            "import type {",
+            "  BootMantleRuntimeArgs,",
+            "  HandlerContext as RuntimeHandlerContext,",
+            "  HandlerFn as RuntimeHandlerFn,",
+            "  MantleRuntime as CoreMantleRuntime,",
+            "  RuntimePlanData,",
+            "} from \"@aotter/mantle/runtime\";",
+            "",
+            `export const plan = sealRuntimePlan(${JSON.stringify(plan, null, 2)} as const satisfies RuntimePlanData);`,
+            "",
+            generatedTypes,
+            "",
+            "export interface MantleViewOptions {",
+            "  readonly page?: number;",
+            "  readonly show?: number;",
+            "  readonly ctx?: RuntimeHandlerContext;",
+            "}",
+            "",
+            "export type MantleHandlers<Env = unknown> = {",
+            ...handlerTypes,
+            "};",
+            "",
+            "export type CreateMantleOptions<Env = unknown> =",
+            "  Omit<BootMantleRuntimeArgs, \"plan\" | \"handlers\"> & {",
+            "    readonly handlers?: MantleHandlers<Env>;",
+            "  };",
+            "",
+            "export async function createMantle<Env = unknown>(options: CreateMantleOptions<Env>) {",
+            "  const runtime = await bootMantleRuntime({ ...options, plan });",
+            "  return bindMantle(runtime);",
+            "}",
+            "",
+            "export function bindMantle(runtime: CoreMantleRuntime) {",
+            "  if (runtime.revision !== plan.semanticFingerprint) {",
+            "    throw new Error(`Generated Mantle revision '${plan.semanticFingerprint}' cannot bind runtime revision '${runtime.revision}'.`);",
+            "  }",
+            "  return {",
+            "    runtime,",
+            "    entries: {",
+            ...schemas.flatMap((schema) => schemaLines(schema.name, namespace)),
+            "    },",
+            "    views: {",
+            ...views.flatMap((view) => viewLines(view.manifest, namespace)),
+            "    },",
+            "    procedures: {",
+            ...procedures.flatMap((procedure) => procedureLines(procedure.manifest.metadata.name, namespace)),
+            "    },",
+            "    triggers: {",
+            ...triggers.map((trigger) => `      ${codegenIdentifier(trigger.name)}: ${JSON.stringify({
+                name: trigger.name,
+                source: trigger.manifest.spec.source,
+                target: trigger.target,
+            })} as const,`),
+            "    },",
+            "  } as const;",
+            "}",
+            "",
+        ].join("\n"),
+    };
+}
+function schemaLines(name, namespace) {
+    const id = codegenIdentifier(name);
+    const data = `${namespace}.Entry_${manifestTypeIdentifier(name)}`;
+    return [
+        `      ${id}: {`,
+        `        createDraft: (request: Omit<Parameters<CoreMantleRuntime["createDraft"]["execute"]>[0], "collection" | "data"> & { readonly data: ${data} }) =>`,
+        `          runtime.createDraft.execute({ ...request, collection: ${JSON.stringify(name)}, data: request.data as unknown as Record<string, unknown> }),`,
+        `        get: (request: Omit<Parameters<CoreMantleRuntime["getEntry"]["execute"]>[0], "collection">) =>`,
+        `          runtime.getEntry.execute({ ...request, collection: ${JSON.stringify(name)} }),`,
+        `        list: (request: Omit<Parameters<CoreMantleRuntime["listEntries"]["execute"]>[0], "collection"> = {}) =>`,
+        `          runtime.listEntries.execute({ ...request, collection: ${JSON.stringify(name)} }),`,
+        `        delete: (request: Omit<Parameters<CoreMantleRuntime["deleteEntry"]["execute"]>[0], "collection">) =>`,
+        `          runtime.deleteEntry.execute({ ...request, collection: ${JSON.stringify(name)} }),`,
+        "      },",
+    ];
+}
+function viewLines(view, namespace) {
+    const name = view.metadata.name;
+    const requiredParams = (view.spec.params?.required?.length ?? 0) > 0;
+    const requestType = view.spec.params
+        ? `MantleViewOptions & { readonly params${requiredParams ? "" : "?"}: ${namespace}.ViewParams_${manifestTypeIdentifier(name)} }`
+        : "MantleViewOptions";
+    return [
+        `      ${codegenIdentifier(name)}: (request: ${requestType}${requiredParams ? "" : " = {}"}) =>`,
+        `        runtime.executeView<${namespace}.ViewRow_${manifestTypeIdentifier(name)}>({`,
+        `          view: ${JSON.stringify(name)},`,
+        "          ctx: request.ctx,",
+        "          options: {",
+        ...(view.spec.params ? ["            params: request.params,"] : []),
+        "            page: request.page,",
+        "            show: request.show,",
+        "          },",
+        "        }),",
+    ];
+}
+function procedureLines(name, namespace) {
+    const typeId = manifestTypeIdentifier(name);
+    return [
+        `      ${codegenIdentifier(name)}: (input: ${namespace}.ProcInput_${typeId}, ctx: RuntimeHandlerContext) =>`,
+        `        runtime.invokeProcedure<${namespace}.ProcOutput_${typeId}>({`,
+        `          procedure: ${JSON.stringify(name)},`,
+        "          input,",
+        "          ctx,",
+        "        }),",
+    ];
+}
+function handlerContractLines(procedures, namespace) {
+    const handlers = new Map();
+    for (const procedure of procedures) {
+        const handler = procedure.manifest.spec.handler;
+        if (handler.kind !== "ref")
+            continue;
+        const entries = handlers.get(handler.ref) ?? [];
+        entries.push(procedure.name);
+        handlers.set(handler.ref, entries);
+    }
+    return [...handlers]
+        .sort(([a], [b]) => compareText(a, b))
+        .map(([ref, entries]) => {
+        const names = entries.map(manifestTypeIdentifier).sort();
+        const inputs = names.map((name) => `${namespace}.ProcInput_${name}`).join(" | ");
+        const outputs = names.map((name) => `${namespace}.ProcOutput_${name}`).join(" | ");
+        return `  readonly ${JSON.stringify(ref)}: RuntimeHandlerFn<${inputs}, ${outputs}, Env>;`;
+    });
+}
+function findIdentifierCollision(linked) {
+    const groups = [
+        ["entries", linked.schemas],
+        ["views", linked.views],
+        ["procedures", linked.procedures],
+        ["triggers", linked.triggers],
+    ];
+    for (const [group, entries] of groups) {
+        const seen = new Map();
+        for (const entry of [...entries].sort((a, b) => compareText(a.manifest.metadata.name, b.manifest.metadata.name))) {
+            const name = entry.manifest.metadata.name;
+            const identifier = codegenIdentifier(name);
+            const first = seen.get(identifier);
+            if (!first) {
+                seen.set(identifier, name);
+                continue;
+            }
+            const source = { ...entry.source, path: "/metadata/name" };
+            return validateDiagnostic({
+                code: "CODEGEN_IDENTIFIER_COLLISION",
+                severity: "error",
+                path: `${source.sourceId}#/${source.documentIndex}/metadata/name`,
+                source,
+                value: name,
+                expected: `a ${group} wire name with a unique lower-camel identifier`,
+                candidates: [first, name],
+                message: `${group} wire names '${first}' and '${name}' both generate '${identifier}'.`,
+            });
+        }
+    }
+    return undefined;
+}
+function sortedValues(record) {
+    return Object.values(record).sort((a, b) => compareText(a.name, b.name));
+}
+function compareText(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function codegenIdentifier(name) {
+    const words = name.match(/[A-Za-z0-9]+/g) ?? [];
+    const joined = words.map((word, index) => index === 0
+        ? word[0].toLowerCase() + word.slice(1)
+        : word[0].toUpperCase() + word.slice(1)).join("");
+    return /^[A-Za-z_$]/.test(joined) ? joined : `_${joined}`;
+}
+//# sourceMappingURL=emitMantleModule.js.map

package/dist/codegen/emitMantleModule.js.map

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

package/dist/codegen.d.ts

@@ -0,0 +1,2 @@
+export { emitMantleModule, type EmitMantleModuleRequest, type EmitMantleModuleResult, } from "./codegen/emitMantleModule.js";
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC"}

package/dist/codegen.js

@@ -0,0 +1,2 @@
+export { emitMantleModule, } from "./codegen/emitMantleModule.js";
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAGjB,MAAM,+BAA+B,CAAC"}

package/dist/provision/renderProvisionBundle.d.ts

@@ -0,0 +1,70 @@
+export declare const PROVISION_BUNDLE_KIND = "mantle-provision-bundle";
+export declare const PROVISION_BUNDLE_FORMAT_VERSION = 1;
+/** Stable across releases: hosts map these to their own error surfaces. */
+export type ProvisionErrorCode = "bundle_invalid" | "bundle_kind_mismatch" | "bundle_archetype_mismatch" | "bundle_too_large" | "binary_invalid" | "path_unsafe" | "path_collision" | "placeholder_unknown" | "placeholder_unresolved" | "launch_value_invalid" | "locale_unsupported" | "locale_catalog_invalid" | "manifest_invalid";
+export declare class ProvisionRenderError extends Error {
+    readonly code: ProvisionErrorCode;
+    constructor(code: ProvisionErrorCode, message: string);
+}
+/** Bounds memory and disk before anything is materialized. */
+export interface ProvisionLimits {
+    readonly maxFiles: number;
+    readonly maxTextBytes: number;
+    readonly maxDecodedBinaryBytes: number;
+    readonly maxTotalBytes: number;
+}
+export declare const DEFAULT_PROVISION_LIMITS: ProvisionLimits;
+export interface ProvisionBundle {
+    readonly kind?: string;
+    readonly version?: string;
+    readonly formatVersion?: number;
+    readonly archetype?: string;
+    readonly files?: Record<string, string>;
+    readonly binaryFiles?: Record<string, string>;
+    readonly localizedFiles?: readonly string[];
+}
+/**
+ * Every placeholder a bundle may reference. A bundle placeholder outside this
+ * set fails as `placeholder_unknown`. Hosts that do not own a value yet (a
+ * local `create` has no GitHub owner) pass an empty string on purpose.
+ */
+export declare const PROVISION_PLACEHOLDERS: readonly ["ADMIN_GITHUB_LOGIN", "AFTER_LAUNCH_SKILL_URL", "ARCHETYPE", "AUTH_MODE", "BRAND", "CANONICAL_LOCALE", "DESCRIPTION", "GITHUB_OWNER", "INSTALL_SUMMARY", "INSTALL_TIMESTAMP", "LOCALES", "PROJECT_NAME", "SITE_URL", "STARTER_REF", "TURNSTILE_SITE_KEY"];
+export type ProvisionPlaceholder = (typeof PROVISION_PLACEHOLDERS)[number];
+export interface LaunchValues {
+    readonly archetype: string;
+    readonly projectName: string;
+    readonly brand: string;
+    readonly description: string;
+    readonly locales: readonly string[];
+    readonly canonicalLocale: string;
+    readonly authMode: string;
+    readonly starterRef: string;
+    /** ISO-8601. Passed in so one input set always renders one output set. */
+    readonly installTimestamp: string;
+    readonly siteUrl?: string;
+    readonly githubOwner?: string;
+    readonly adminGithubLogin?: string;
+    readonly afterLaunchSkillUrl?: string;
+    readonly installSummary?: string;
+    readonly turnstileSiteKey?: string;
+}
+export interface RenderProvisionBundleInput {
+    readonly bundle: ProvisionBundle;
+    readonly launch: LaunchValues;
+    readonly limits?: ProvisionLimits;
+}
+export interface RenderedProject {
+    /** Relative POSIX path -> file text. */
+    readonly files: ReadonlyMap<string, string>;
+    /** Relative POSIX path -> canonical base64. */
+    readonly binaryFiles: ReadonlyMap<string, string>;
+}
+export declare function renderProvisionBundle(input: RenderProvisionBundleInput): RenderedProject;
+/**
+ * Normalizes both slash styles and rejects anything that could escape the
+ * target. Returns the path a host will join onto its destination, so every
+ * rule below runs on that final string — never on the raw bundle key.
+ */
+export declare function safeTarget(rawPath: string): string;
+export declare function isCanonicalBase64(value: string): boolean;
+//# sourceMappingURL=renderProvisionBundle.d.ts.map

package/dist/provision/renderProvisionBundle.d.ts.map

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