@distilled.cloud/core 1.0.0-rc.7 → 1.0.0-rc.9

package/lib/codegen/patches.d.ts

@@ -0,0 +1,65 @@
+import { type JsonPatchOperation } from "../json-patch.ts";
+export type OnStalePatch = "fail" | "warn";
+export interface ApplyPatchesResult {
+    files: number;
+    applied: number;
+    stale: number;
+    errors: string[];
+}
+/** Smithy-model JSON pointers — OpenAPI has no `/shapes` tree. */
+export declare const isSmithyPatchPath: (pointer: string) => boolean;
+/**
+ * RFC-6902 files in `dir`: every `*.json`, `*.manual.json` last (those
+ * usually target post-rename shape names). Missing dir → `[]`.
+ */
+export declare const listRfc6902PatchFiles: (dir: string) => Promise<string[]>;
+export declare const applyRfc6902Files: (target: unknown, files: readonly string[], opts?: {
+    readonly onStalePatch?: OnStalePatch;
+    readonly include?: (op: JsonPatchOperation) => boolean;
+    readonly label?: (file: string) => string;
+}) => Promise<ApplyPatchesResult>;
+/**
+ * An RFC-6902 `move` that renames an operation shape leaves the service's
+ * `operations` list pointing at the old id. Drop entries whose target no
+ * longer exists and append operation shapes the list is missing, keeping
+ * the existing order. Returns the number of services whose list changed.
+ */
+export declare const syncServiceOperations: (model: {
+    shapes?: Record<string, any>;
+}) => number;
+/**
+ * Every `target` in a Smithy model must resolve to a shape or a prelude
+ * (`smithy.api#…`) id. Returns the dangling ones as `"<owner> → <target>"`.
+ * A convert that produces any is broken — generate would emit references
+ * to types that do not exist.
+ */
+export declare const danglingTargets: (model: {
+    shapes?: Record<string, any>;
+}) => string[];
+/**
+ * Last step of every convert: Smithy RFC-6902 patches, then verbNoun
+ * operation names, then an optional model transform, then a reference
+ * check. Writes models back so `.generated-specs` is what generate
+ * compiles. `outDir` may be nested (GCP `stable/` / `unstable/`).
+ *
+ * Input must be FRESHLY converted models. Smithy patches are `move`/`add`
+ * ops that are not idempotent, and a `transform` may not be either, so
+ * running this over a model that already went through it is an error —
+ * re-run the package's `convert` instead.
+ */
+export declare const finalizeConvert: (o: {
+    readonly root: string;
+    readonly outDir?: string;
+    readonly patchesDir?: string | false;
+    readonly exclude?: (file: string) => boolean;
+    readonly include?: (resource: string) => boolean;
+    readonly transform?: (model: any, resource: string) => string | void;
+    readonly operationNaming?: "as-is" | "verbNoun";
+    readonly onStalePatch?: OnStalePatch;
+}) => Promise<void>;
+/**
+ * Metadata marker stamped by {@link finalizeConvert}. Guards against a
+ * second pass over the same file (see the note on finalizeConvert).
+ */
+export declare const FINALIZED_KEY = "distilled.finalized";
+//# sourceMappingURL=patches.d.ts.map

package/lib/codegen/patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patches.d.ts","sourceRoot":"","sources":["../../src/codegen/patches.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,OAGrB,CAAC;AAWhC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAe,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAUzE,CAAC;AAEF,eAAO,MAAM,iBAAiB,WACpB,OAAO,SACR,SAAS,MAAM,EAAE,SAClB;IACJ,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C,KACA,OAAO,CAAC,kBAAkB,CAmC5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,UAAW;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,KAAG,MAqBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,UAAW;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,KAAG,MAAM,EAwBT,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,MAAa;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC,KAAG,OAAO,CAAC,IAAI,CAgGf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,wBAAwB,CAAC"}

package/lib/codegen/patches.js

@@ -0,0 +1,236 @@
+/**
+ * RFC-6902 patch application for convert (dev-time only).
+ *
+ * OpenAPI ops (`/paths`, `/components`, …) apply to the spec before
+ * conversion; Smithy ops (`/shapes`, `/metadata`, `/smithy`) apply to the
+ * model after conversion. `.generated-specs` is the patched model.
+ * `scripts/generate.ts` does not apply patches.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { applyOperation, isStaleTargetError, } from "../json-patch.js";
+import { verbNounSmithyModel } from "./rewrite-operation-ids.js";
+/** Smithy-model JSON pointers — OpenAPI has no `/shapes` tree. */
+export const isSmithyPatchPath = (pointer) => pointer.startsWith("/shapes") ||
+    pointer.startsWith("/metadata") ||
+    pointer.startsWith("/smithy");
+const exists = async (p) => {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * RFC-6902 files in `dir`: every `*.json`, `*.manual.json` last (those
+ * usually target post-rename shape names). Missing dir → `[]`.
+ */
+export const listRfc6902PatchFiles = async (dir) => {
+    if (!(await exists(dir)))
+        return [];
+    return (await fs.readdir(dir))
+        .filter((f) => f.endsWith(".json"))
+        .sort((a, b) => Number(a.endsWith(".manual.json")) -
+        Number(b.endsWith(".manual.json")) || a.localeCompare(b))
+        .map((f) => path.join(dir, f));
+};
+export const applyRfc6902Files = async (target, files, opts = {}) => {
+    const onStalePatch = opts.onStalePatch ?? "fail";
+    const include = opts.include ?? (() => true);
+    const result = {
+        files: 0,
+        applied: 0,
+        stale: 0,
+        errors: [],
+    };
+    for (const file of files) {
+        const parsed = JSON.parse(await fs.readFile(file, "utf8"));
+        const label = opts.label?.(file) ?? path.basename(file);
+        result.files++;
+        for (const patchOp of parsed.patches ?? []) {
+            if (!include(patchOp))
+                continue;
+            try {
+                applyOperation(target, patchOp);
+                result.applied++;
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                const line = `${label} [${patchOp.op} ${patchOp.path}]`;
+                if (isStaleTargetError(e)) {
+                    result.stale++;
+                    if (onStalePatch === "fail") {
+                        result.errors.push(`${line}: stale target (${msg})`);
+                    }
+                    else {
+                        console.warn(`   ⚠️  stale: ${line}`);
+                    }
+                }
+                else {
+                    result.errors.push(`${line}: ${msg}`);
+                }
+            }
+        }
+    }
+    return result;
+};
+/**
+ * An RFC-6902 `move` that renames an operation shape leaves the service's
+ * `operations` list pointing at the old id. Drop entries whose target no
+ * longer exists and append operation shapes the list is missing, keeping
+ * the existing order. Returns the number of services whose list changed.
+ */
+export const syncServiceOperations = (model) => {
+    const shapes = model.shapes ?? {};
+    const opIds = Object.keys(shapes).filter((id) => shapes[id]?.type === "operation");
+    let changed = 0;
+    for (const def of Object.values(shapes)) {
+        if (def?.type !== "service")
+            continue;
+        const current = def.operations ?? [];
+        const kept = current.filter((o) => shapes[o.target]?.type === "operation");
+        const listed = new Set(kept.map((o) => o.target));
+        const after = [
+            ...kept,
+            ...opIds.filter((id) => !listed.has(id)).map((target) => ({ target })),
+        ];
+        if (JSON.stringify(current) !== JSON.stringify(after)) {
+            def.operations = after;
+            changed++;
+        }
+    }
+    return changed;
+};
+/**
+ * Every `target` in a Smithy model must resolve to a shape or a prelude
+ * (`smithy.api#…`) id. Returns the dangling ones as `"<owner> → <target>"`.
+ * A convert that produces any is broken — generate would emit references
+ * to types that do not exist.
+ */
+export const danglingTargets = (model) => {
+    const shapes = model.shapes ?? {};
+    const ids = new Set(Object.keys(shapes));
+    const out = [];
+    const walk = (owner, node) => {
+        if (Array.isArray(node)) {
+            for (const item of node)
+                walk(owner, item);
+            return;
+        }
+        if (node === null || typeof node !== "object")
+            return;
+        for (const [key, value] of Object.entries(node)) {
+            if (key === "target" && typeof value === "string") {
+                if (!value.startsWith("smithy.") && !ids.has(value)) {
+                    out.push(`${owner} → ${value}`);
+                }
+            }
+            else {
+                walk(owner, value);
+            }
+        }
+    };
+    for (const [id, def] of Object.entries(shapes))
+        walk(id, def);
+    return out;
+};
+/**
+ * Last step of every convert: Smithy RFC-6902 patches, then verbNoun
+ * operation names, then an optional model transform, then a reference
+ * check. Writes models back so `.generated-specs` is what generate
+ * compiles. `outDir` may be nested (GCP `stable/` / `unstable/`).
+ *
+ * Input must be FRESHLY converted models. Smithy patches are `move`/`add`
+ * ops that are not idempotent, and a `transform` may not be either, so
+ * running this over a model that already went through it is an error —
+ * re-run the package's `convert` instead.
+ */
+export const finalizeConvert = async (o) => {
+    const specsDir = path.resolve(o.root, o.outDir ?? ".generated-specs");
+    if (!(await exists(specsDir)))
+        return;
+    const patchesDir = o.patchesDir === false
+        ? undefined
+        : path.resolve(o.root, o.patchesDir ?? "patches");
+    const naming = o.operationNaming ?? "verbNoun";
+    const walk = async (dir) => {
+        const out = [];
+        for (const ent of await fs.readdir(dir, { withFileTypes: true })) {
+            const p = path.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                out.push(...(await walk(p)));
+            }
+            else if (ent.name.endsWith(".json") &&
+                !(o.exclude?.(ent.name) ?? false)) {
+                out.push(p);
+            }
+        }
+        return out;
+    };
+    const files = (await walk(specsDir)).sort((a, b) => a.localeCompare(b));
+    const broken = [];
+    for (const modelPath of files) {
+        const resource = path.basename(modelPath, ".json");
+        if (o.include && !o.include(resource))
+            continue;
+        const model = JSON.parse(await fs.readFile(modelPath, "utf8"));
+        if (model.metadata?.[FINALIZED_KEY]) {
+            throw new Error(`${path.relative(o.root, modelPath)} was already finalized — finalizeConvert is not idempotent; re-run this package's convert from the spec instead`);
+        }
+        if (patchesDir) {
+            const patchFiles = await listRfc6902PatchFiles(path.join(patchesDir, resource));
+            const applied = await applyRfc6902Files(model, patchFiles, {
+                onStalePatch: o.onStalePatch,
+                include: (op) => isSmithyPatchPath(op.path),
+                label: (f) => `${resource}/${path.basename(f)}`,
+            });
+            if (applied.errors.length) {
+                for (const err of applied.errors)
+                    console.error(`❌ bad patch: ${err}`);
+                throw new Error(`${applied.errors.length} patch operation(s) failed for ${resource} — fix the pointers or delete the patch`);
+            }
+            if (applied.applied > 0) {
+                console.log(`   patched ${resource}: ${applied.files} file(s), ${applied.applied} op(s)` +
+                    (applied.stale ? `, ${applied.stale} stale` : ""));
+            }
+        }
+        if (naming === "verbNoun") {
+            const { renamed, collisions } = verbNounSmithyModel(model);
+            if (renamed > 0) {
+                console.log(`   verbNoun ${resource}: renamed ${renamed} operation(s)`);
+            }
+            for (const c of collisions) {
+                console.warn(`   ⚠️  verbNoun collision ${resource}: ${c} (kept original)`);
+            }
+        }
+        const note = o.transform?.(model, resource);
+        if (note)
+            console.log(`   ${note}`);
+        syncServiceOperations(model);
+        const dangling = danglingTargets(model);
+        if (dangling.length) {
+            broken.push(`${resource}: ${dangling.length} dangling target(s)`);
+            for (const d of dangling.slice(0, 5))
+                console.error(`   ❌ ${d}`);
+            if (dangling.length > 5) {
+                console.error(`   … ${dangling.length - 5} more`);
+            }
+            // Leave the unfinalized model on disk for inspection; never stamp
+            // a model that generate cannot compile.
+            continue;
+        }
+        model.metadata = { ...model.metadata, [FINALIZED_KEY]: true };
+        await fs.writeFile(modelPath, `${JSON.stringify(model, null, 2)}\n`);
+    }
+    if (broken.length) {
+        throw new Error(`finalizeConvert: ${broken.length} model(s) reference shapes that do not exist:\n  ${broken.join("\n  ")}`);
+    }
+};
+/**
+ * Metadata marker stamped by {@link finalizeConvert}. Guards against a
+ * second pass over the same file (see the note on finalizeConvert).
+ */
+export const FINALIZED_KEY = "distilled.finalized";
+//# sourceMappingURL=patches.js.map

package/lib/codegen/patches.js.map

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

package/lib/codegen/patches.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=patches.test.d.ts.map

package/lib/codegen/patches.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patches.test.d.ts","sourceRoot":"","sources":["../../src/codegen/patches.test.ts"],"names":[],"mappings":""}

package/lib/codegen/patches.test.js

@@ -0,0 +1,105 @@
+import { describe, expect, test } from "bun:test";
+import { mkdtempSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { FINALIZED_KEY, danglingTargets, finalizeConvert, syncServiceOperations, } from "./patches.js";
+const model = () => ({
+    smithy: "2.0",
+    shapes: {
+        "ns#Svc": {
+            type: "service",
+            operations: [{ target: "ns#AppsList" }, { target: "ns#AppsGet" }],
+        },
+        "ns#AppsList": {
+            type: "operation",
+            input: { target: "ns#AppsListRequest" },
+            output: { target: "smithy.api#Unit" },
+        },
+        "ns#AppsListRequest": { type: "structure", members: {} },
+        "ns#AppsGet": {
+            type: "operation",
+            input: { target: "smithy.api#Unit" },
+            output: { target: "smithy.api#Unit" },
+        },
+    },
+});
+const scaffold = (patches) => {
+    const root = mkdtempSync(join(tmpdir(), "finalize-"));
+    mkdirSync(join(root, ".generated-specs"));
+    writeFileSync(join(root, ".generated-specs", "svc.json"), JSON.stringify(model()));
+    if (patches) {
+        mkdirSync(join(root, "patches", "svc"), { recursive: true });
+        writeFileSync(join(root, "patches", "svc", "a.json"), JSON.stringify(patches));
+    }
+    return root;
+};
+const read = (root) => JSON.parse(readFileSync(join(root, ".generated-specs", "svc.json"), "utf8"));
+describe("finalizeConvert", () => {
+    test("renames, syncs the service list, stamps the marker", async () => {
+        const root = scaffold();
+        await finalizeConvert({ root });
+        const m = read(root);
+        expect(Object.keys(m.shapes).sort()).toEqual(["ns#Svc", "ns#ListApps", "ns#ListAppsRequest", "ns#GetApp"].sort());
+        expect(m.shapes["ns#Svc"].operations).toEqual([
+            { target: "ns#ListApps" },
+            { target: "ns#GetApp" },
+        ]);
+        expect(m.metadata[FINALIZED_KEY]).toBe(true);
+    });
+    test("refuses a second pass", async () => {
+        const root = scaffold();
+        await finalizeConvert({ root });
+        await expect(finalizeConvert({ root })).rejects.toThrow(/already finalized/);
+    });
+    test("applies Smithy patches and repairs the service list after a move", async () => {
+        const root = scaffold({
+            patches: [
+                { op: "move", from: "/shapes/ns#AppsGet", path: "/shapes/ns#FetchApp" },
+            ],
+        });
+        await finalizeConvert({ root });
+        const m = read(root);
+        expect(m.shapes["ns#FetchApp"]).toBeDefined();
+        expect(m.shapes["ns#Svc"].operations.map((o) => o.target)).toEqual([
+            "ns#ListApps",
+            "ns#FetchApp",
+        ]);
+    });
+    test("fails on a stale patch pointer by default", async () => {
+        const root = scaffold({
+            patches: [{ op: "remove", path: "/shapes/ns#Missing" }],
+        });
+        await expect(finalizeConvert({ root })).rejects.toThrow(/failed/);
+    });
+    test("fails on dangling targets and leaves the model unstamped", async () => {
+        const root = scaffold({
+            patches: [
+                {
+                    op: "replace",
+                    path: "/shapes/ns#AppsList/output/target",
+                    value: "ns#Nope",
+                },
+            ],
+        });
+        await expect(finalizeConvert({ root })).rejects.toThrow(/do not exist/);
+        expect(read(root).metadata?.[FINALIZED_KEY]).toBeUndefined();
+    });
+});
+describe("danglingTargets", () => {
+    test("ignores prelude ids", () => {
+        expect(danglingTargets(model())).toEqual([]);
+    });
+});
+describe("syncServiceOperations", () => {
+    test("drops missing and appends unlisted, keeping order", () => {
+        const m = model();
+        delete m.shapes["ns#AppsGet"];
+        m.shapes["ns#Zed"] = { type: "operation" };
+        expect(syncServiceOperations(m)).toBe(1);
+        expect(m.shapes["ns#Svc"].operations).toEqual([
+            { target: "ns#AppsList" },
+            { target: "ns#Zed" },
+        ]);
+    });
+});
+//# sourceMappingURL=patches.test.js.map

package/lib/codegen/patches.test.js.map

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

package/lib/codegen/proto.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Proto3 → Smithy 2.0 JSON converter (dev-time only, provider-agnostic).
+ *
+ * Turns one or more `.proto` files (a package of messages, enums, and gRPC
+ * services) into the same Smithy JSON model shape the other spec converters
+ * produce (`{ smithy: "2.0", metadata, shapes }`), so a proto-sourced
+ * provider flows through the shared `generateService` compiler.
+ *
+ * Mapping (proto3 JSON encoding on the wire):
+ *
+ *   • each selected unary `rpc` → a Smithy operation, `POST /<package>.<Service>/<Method>`
+ *   • request/response messages → structures; members are camelCase (proto3 JSON)
+ *   • `repeated` → list, `map<k,v>` → map (JSON object keys are strings)
+ *   • `oneof` fields flatten onto the parent (proto3 JSON is untagged)
+ *   • enums → string enums (proto3 JSON emits the name)
+ *   • 64-bit integers → `smithy.api#String` (proto3 JSON encodes them as strings)
+ *   • `bytes` → `smithy.api#Blob` (base64 on the JSON wire)
+ *   • `google.protobuf.Empty` I/O → `smithy.api#Unit`
+ *   • streaming RPCs are skipped by default (they are not request/response POSTs)
+ *
+ * The converter does not speak binary protobuf. Generated SDKs send proto3
+ * JSON at the gRPC method path — Connect-JSON / grpc-JSON transcoding shape.
+ */
+export declare const PRELUDE: {
+    readonly String: "smithy.api#String";
+    readonly Boolean: "smithy.api#Boolean";
+    readonly Integer: "smithy.api#Integer";
+    readonly Long: "smithy.api#Long";
+    readonly Float: "smithy.api#Float";
+    readonly Double: "smithy.api#Double";
+    readonly Timestamp: "smithy.api#Timestamp";
+    readonly Blob: "smithy.api#Blob";
+    readonly Document: "smithy.api#Document";
+    readonly Unit: "smithy.api#Unit";
+};
+export interface ProtoField {
+    readonly name: string;
+    readonly type: string;
+    readonly repeated: boolean;
+    readonly optional: boolean;
+    readonly mapKey?: string;
+    readonly mapValue?: string;
+    readonly jsonName?: string;
+    readonly deprecated: boolean;
+    readonly documentation?: string;
+}
+export interface ProtoEnumValue {
+    readonly name: string;
+    readonly number: number;
+    readonly deprecated: boolean;
+    readonly documentation?: string;
+}
+export interface ProtoEnum {
+    readonly name: string;
+    readonly fullName: string;
+    readonly values: ProtoEnumValue[];
+    readonly documentation?: string;
+}
+export interface ProtoMessage {
+    readonly name: string;
+    readonly fullName: string;
+    readonly fields: ProtoField[];
+    readonly messages: ProtoMessage[];
+    readonly enums: ProtoEnum[];
+    readonly documentation?: string;
+}
+export interface ProtoRpc {
+    readonly name: string;
+    readonly requestType: string;
+    readonly responseType: string;
+    readonly requestStream: boolean;
+    readonly responseStream: boolean;
+    readonly deprecated: boolean;
+    readonly documentation?: string;
+}
+export interface ProtoService {
+    readonly name: string;
+    readonly fullName: string;
+    readonly rpcs: ProtoRpc[];
+    readonly documentation?: string;
+}
+export interface ProtoFile {
+    readonly filename: string;
+    readonly package: string;
+    readonly syntax: string;
+    readonly imports: string[];
+    readonly messages: ProtoMessage[];
+    readonly enums: ProtoEnum[];
+    readonly services: ProtoService[];
+}
+export interface ProtoConvertOptions {
+    readonly files: readonly ProtoFile[];
+    readonly namespace: string;
+    readonly serviceName: string;
+    readonly serviceTitle?: string;
+    readonly serviceDocumentation?: string;
+    readonly serviceVersion?: string;
+    /** Fully-qualified proto service (`modal.client.ModalClient`). */
+    readonly protoService: string;
+    /** Keep only these RPC names. Default: every unary RPC. */
+    readonly rpcNames?: ReadonlySet<string>;
+    readonly skipStreaming?: boolean;
+    readonly skipDeprecated?: boolean;
+}
+export interface ProtoConvertResult {
+    readonly model: {
+        smithy: "2.0";
+        metadata: Record<string, unknown>;
+        shapes: Record<string, any>;
+    };
+    readonly converted: number;
+    readonly skippedStreaming: number;
+    readonly skippedDeprecated: number;
+    readonly shapeCount: number;
+}
+/** Parse a proto3 source file into an AST. */
+export declare const parseProto: (text: string, filename?: string) => ProtoFile;
+/** Leading PascalCase token of an RPC name (`AppCreate` → `App`). */
+export declare const rpcGroupName: (rpcName: string) => string;
+export declare const convertProtoToSmithy: (options: ProtoConvertOptions) => ProtoConvertResult;
+//# sourceMappingURL=proto.d.ts.map

package/lib/codegen/proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.d.ts","sourceRoot":"","sources":["../../src/codegen/proto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,eAAO,MAAM,OAAO;aAClB,MAAM,EAAE,mBAAmB;aAC3B,OAAO,EAAE,oBAAoB;aAC7B,OAAO,EAAE,oBAAoB;aAC7B,IAAI,EAAE,iBAAiB;aACvB,KAAK,EAAE,kBAAkB;aACzB,MAAM,EAAE,mBAAmB;aAC3B,SAAS,EAAE,sBAAsB;aACjC,IAAI,EAAE,iBAAiB;aACvB,QAAQ,EAAE,qBAAqB;aAC/B,IAAI,EAAE,iBAAiB;CACf,CAAC;AA4CX,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA4dD,8CAA8C;AAC9C,eAAO,MAAM,UAAU,SACf,MAAM,wBAEX,SAQF,CAAC;AAwVF,qEAAqE;AACrE,eAAO,MAAM,YAAY,YAAa,MAAM,KAAG,MAG9C,CAAC;AAEF,eAAO,MAAM,oBAAoB,YACtB,mBAAmB,KAC3B,kBAmHF,CAAC"}