@autoview/cli 0.1.0

package/lib/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Self-contained replacements for the `@autobe/utils` surface this package
+ * uses. Migrated 2026-06-01 as Step 2 of the AutoBE-independence track — the
+ * underlying conversions still rely on the typia / nestia ecosystem
+ * (`@typia/utils`, `@typia/interface`), which are not AutoBE packages.
+ */
+export * from "./StringUtil";
+export * from "./ArrayUtil";
+export * from "./toEndpoints";
+export * from "./classifyEndpoints";
+export * from "./endpointFilter";
+export * from "./extractFields";
+export * from "./resourcePlan";

package/lib/utils/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Self-contained replacements for the `@autobe/utils` surface this package
+ * uses. Migrated 2026-06-01 as Step 2 of the AutoBE-independence track — the
+ * underlying conversions still rely on the typia / nestia ecosystem
+ * (`@typia/utils`, `@typia/interface`), which are not AutoBE packages.
+ */
+__exportStar(require("./StringUtil"), exports);
+__exportStar(require("./ArrayUtil"), exports);
+__exportStar(require("./toEndpoints"), exports);
+__exportStar(require("./classifyEndpoints"), exports);
+__exportStar(require("./endpointFilter"), exports);
+__exportStar(require("./extractFields"), exports);
+__exportStar(require("./resourcePlan"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,+CAA6B;AAC7B,8CAA4B;AAC5B,gDAA8B;AAC9B,sDAAoC;AACpC,mDAAiC;AACjC,kDAAgC;AAChC,iDAA+B"}

package/lib/utils/normalizeForNestia.d.ts

@@ -0,0 +1,34 @@
+import { OpenApi } from "@typia/interface";
+/**
+ * Normalize a real-world OpenAPI document so nestia (`HttpMigration` and
+ * `@nestia/migrate`) can turn EVERY operation into a compilable typed route.
+ * Real swaggers carry shapes that nestia faithfully reproduces but its own typed
+ * fetcher then rejects (or refuses to emit), silently dropping screens and SDK
+ * functions. This pass rewrites only those shapes — additively, never removing a
+ * route that already worked — and is applied identically by the READ layer
+ * (`toEndpoints`) and the SDK compiler so the screen plan and the SDK stay in
+ * lockstep.
+ *
+ * Two corrections, both seen in the wild:
+ *
+ * 1. **Multi-object query → dropped route.** nestia drops an entire route when
+ *    its query has more than one object-typed parameter
+ *    (`query typed parameters must be only one object type`). Apideck's
+ *    `GET /accounting/invoices` carries `filter`, `sort` AND `pass_through`
+ *    objects — the very list that produces ids for navigation. We keep only the
+ *    first object-typed query param; AutoView rebuilds the complete query from
+ *    the untouched original document (`buildQuerySchema`) and the list page
+ *    casts its query argument, so nothing the UI sees is lost.
+ *
+ * 2. **Body on a GET/HEAD → uncompilable SDK.** Notion's `GET /v1/comments` and
+ *    `GET /v1/users/{id}` declare an `application/x-www-form-urlencoded`
+ *    requestBody. A body on GET/HEAD is invalid HTTP; nestia still emits a GET
+ *    SDK function carrying a request body, which its fetcher (body only on
+ *    DELETE/POST/PUT/PATCH) rejects — a hard type error that also leaves those
+ *    pages empty at runtime. We strip the requestBody from GET/HEAD operations.
+ *
+ * Pure: the input document is never mutated. Only operations that actually need
+ * a correction are rebuilt; everything else is shared by reference, and a
+ * document needing no correction is returned as-is (same reference).
+ */
+export declare function normalizeForNestia(document: OpenApi.IDocument): OpenApi.IDocument;

package/lib/utils/normalizeForNestia.js

@@ -0,0 +1,133 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeForNestia = normalizeForNestia;
+const utils_1 = require("@typia/utils");
+/**
+ * Normalize a real-world OpenAPI document so nestia (`HttpMigration` and
+ * `@nestia/migrate`) can turn EVERY operation into a compilable typed route.
+ * Real swaggers carry shapes that nestia faithfully reproduces but its own typed
+ * fetcher then rejects (or refuses to emit), silently dropping screens and SDK
+ * functions. This pass rewrites only those shapes — additively, never removing a
+ * route that already worked — and is applied identically by the READ layer
+ * (`toEndpoints`) and the SDK compiler so the screen plan and the SDK stay in
+ * lockstep.
+ *
+ * Two corrections, both seen in the wild:
+ *
+ * 1. **Multi-object query → dropped route.** nestia drops an entire route when
+ *    its query has more than one object-typed parameter
+ *    (`query typed parameters must be only one object type`). Apideck's
+ *    `GET /accounting/invoices` carries `filter`, `sort` AND `pass_through`
+ *    objects — the very list that produces ids for navigation. We keep only the
+ *    first object-typed query param; AutoView rebuilds the complete query from
+ *    the untouched original document (`buildQuerySchema`) and the list page
+ *    casts its query argument, so nothing the UI sees is lost.
+ *
+ * 2. **Body on a GET/HEAD → uncompilable SDK.** Notion's `GET /v1/comments` and
+ *    `GET /v1/users/{id}` declare an `application/x-www-form-urlencoded`
+ *    requestBody. A body on GET/HEAD is invalid HTTP; nestia still emits a GET
+ *    SDK function carrying a request body, which its fetcher (body only on
+ *    DELETE/POST/PUT/PATCH) rejects — a hard type error that also leaves those
+ *    pages empty at runtime. We strip the requestBody from GET/HEAD operations.
+ *
+ * Pure: the input document is never mutated. Only operations that actually need
+ * a correction are rebuilt; everything else is shared by reference, and a
+ * document needing no correction is returned as-is (same reference).
+ */
+function normalizeForNestia(document) {
+    var _a;
+    const paths = (_a = document.paths) !== null && _a !== void 0 ? _a : {};
+    let changed = false;
+    const nextPaths = {};
+    for (const [path, item] of Object.entries(paths)) {
+        const relaxed = normalizePathItem(item, document);
+        nextPaths[path] = relaxed.item;
+        changed = changed || relaxed.changed;
+    }
+    if (!changed)
+        return document;
+    // biome-ignore lint: structurally an OpenApi.IDocument with a rebuilt paths map
+    return Object.assign(Object.assign({}, document), { paths: nextPaths });
+}
+const HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head"];
+/** HTTP methods whose request body nestia's typed fetcher cannot carry. */
+const BODYLESS_METHODS = new Set(["get", "head"]);
+function normalizePathItem(item, document) {
+    let changed = false;
+    const next = Object.assign({}, item);
+    for (const method of HTTP_METHODS) {
+        const op = item[method];
+        if (op === undefined)
+            continue;
+        const normalized = normalizeOperation(op, method, document);
+        if (normalized !== op) {
+            next[method] = normalized;
+            changed = true;
+        }
+    }
+    return changed ? { item: next, changed } : { item, changed: false };
+}
+function normalizeOperation(operation, method, document) {
+    let next = operation;
+    next = stripBodyFromBodylessMethod(next, method);
+    next = relaxMultiObjectQuery(next, document);
+    return next;
+}
+/**
+ * Remove the requestBody from a GET/HEAD operation — a body is invalid there and
+ * makes nestia emit an SDK function its own fetcher rejects.
+ */
+function stripBodyFromBodylessMethod(operation, method) {
+    if (!BODYLESS_METHODS.has(method))
+        return operation;
+    if (operation.requestBody === undefined)
+        return operation;
+    const _a = operation, { requestBody: _dropped } = _a, rest = __rest(_a, ["requestBody"]);
+    return rest;
+}
+/**
+ * Keep only the first object-typed query parameter, or return the operation
+ * unchanged when it has ≤1 such param.
+ */
+function relaxMultiObjectQuery(operation, document) {
+    const params = operation.parameters;
+    if (!Array.isArray(params))
+        return operation;
+    const objectQueryIndexes = params
+        .map((p, i) => p.in === "query" && isObjectQuerySchema(p.schema, document) ? i : -1)
+        .filter((i) => i >= 0);
+    if (objectQueryIndexes.length <= 1)
+        return operation;
+    const drop = new Set(objectQueryIndexes.slice(1));
+    return Object.assign(Object.assign({}, operation), { parameters: params.filter((_, i) => !drop.has(i)) });
+}
+/**
+ * Mirror of the composer's object test (HttpMigrateRouteComposer): a query param
+ * counts as an "object" when its schema is an object, or a `$ref` to a component
+ * schema that is an object.
+ */
+function isObjectQuerySchema(schema, document) {
+    var _a, _b, _c;
+    if (schema === undefined)
+        return false;
+    if (utils_1.OpenApiTypeChecker.isObject(schema))
+        return true;
+    if (utils_1.OpenApiTypeChecker.isReference(schema)) {
+        const name = (_a = schema.$ref.split("/").pop()) !== null && _a !== void 0 ? _a : "";
+        const target = ((_c = (_b = document.components) === null || _b === void 0 ? void 0 : _b.schemas) !== null && _c !== void 0 ? _c : {})[name];
+        return target !== undefined && utils_1.OpenApiTypeChecker.isObject(target);
+    }
+    return false;
+}
+//# sourceMappingURL=normalizeForNestia.js.map

package/lib/utils/normalizeForNestia.js.map

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

package/lib/utils/resourcePlan.d.ts

@@ -0,0 +1,39 @@
+import { OpenApi } from "@typia/interface";
+import { IClassifiedEndpoint, IResourceGroup } from "./classifyEndpoints";
+import { IAutoViewEndpoint } from "./toEndpoints";
+/**
+ * Deterministic information architecture — the second brick of the "정확한 틀".
+ *
+ * Turns the classified resource groups into a concrete, reproducible screen
+ * set: for each resource, exactly the screens its CRUD roles justify, with real
+ * Next.js paths and the endpoints each screen composes. No LLM, no commerce
+ * baseline, no "5-25 screens, compose, don't enumerate" guesswork — every
+ * resource that exposes a capability gets the corresponding screen, and
+ * nothing more.
+ *
+ * This is what replaces the LLM ProductPlan's IShop-flavored improvisation:
+ * the Render phase later fills these slots with TSX, but the SET of screens is
+ * decided here, structurally.
+ */
+export type ScreenKind = "list" | "detail" | "create" | "edit";
+export interface IPlannedScreen {
+    /** Next.js App Router path, dynamic segments in `[brackets]`. */
+    path: string;
+    resource: string;
+    kind: ScreenKind;
+    /** Hierarchy depth: 1 = top-level resource, ≥2 = nested under a parent. */
+    depth: number;
+    /** Parent collection path (`/sales/[saleId]`) for a nested resource, else null. */
+    parentPath: string | null;
+    title: string;
+    /** Primary data-source / target endpoint for the screen. */
+    primary: IAutoViewEndpoint;
+    /**
+     * Secondary endpoints the screen wires in — e.g. a detail screen surfaces
+     * its update / delete / action endpoints as buttons; a list screen links to
+     * detail. Empty for create.
+     */
+    secondary: IClassifiedEndpoint[];
+}
+export declare function planResource(group: IResourceGroup): IPlannedScreen[];
+export declare function resourcePlan(endpoints: IAutoViewEndpoint[], document?: OpenApi.IDocument): IPlannedScreen[];

package/lib/utils/resourcePlan.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planResource = planResource;
+exports.resourcePlan = resourcePlan;
+const classifyEndpoints_1 = require("./classifyEndpoints");
+function pick(group, role) {
+    return group.endpoints.filter((c) => c.role === role);
+}
+function titleize(resource) {
+    const spaced = resource.replace(/[_-]+/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2");
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+ * Canonical route param name for a resource: `<name>Id`. Derived from the
+ * resource NAME (not the endpoint's param), so it is identical everywhere the
+ * resource appears (its own detail and as a parent of a sub-resource) and
+ * distinct from every other resource's param. This guarantees a route never has
+ * a sibling-slug conflict (`/sales/[id]` vs `/sales/[saleId]`) nor a repeated
+ * slug within one path (`/sales/[id]/questions/[id]`) — both of which Next.js
+ * rejects at boot. The SDK's own param names are recovered separately by
+ * position when the page issues its fetch.
+ */
+function canonParam(name) {
+    return `${name.replace(/[^A-Za-z0-9]/g, "")}Id`;
+}
+/**
+ * The collection route for a resource group, mirroring the swagger hierarchy:
+ * every parent link contributes `<name>/[<canonParam>]`, the leaf its bare name.
+ * `[sales, questions]` → `/sales/[salesId]/questions`. `[sales]` → `/sales`.
+ */
+/** A parent link's route part: `sales/[salesId]` when item-addressed, else just
+ * `coupons` (a path prefix with no `{param}`, so no bracket). */
+function parentPart(link) {
+    return link.param !== null ? `${link.name}/[${canonParam(link.name)}]` : link.name;
+}
+function collectionPath(group) {
+    const links = group.chain;
+    const parts = links.map((c, i) => (i < links.length - 1 ? parentPart(c) : c.name));
+    return `/${parts.join("/")}`;
+}
+/** The parent collection path (`/sales/[salesId]`) for a nested group, else null. */
+function parentPathOf(group) {
+    if (group.chain.length < 2)
+        return null;
+    const parents = group.chain.slice(0, -1);
+    return `/${parents.map(parentPart).join("/")}`;
+}
+/** Item route param for a group's own entity (`/sales` → `[salesId]`). */
+function itemParam(group) {
+    return canonParam(group.resource);
+}
+function planResource(group) {
+    const screens = [];
+    const resource = group.resource;
+    const label = titleize(resource);
+    const depth = group.chain.length;
+    const parentPath = parentPathOf(group);
+    const base = collectionPath(group);
+    const common = { resource, depth, parentPath };
+    // Prefer the top-level enumeration as the resource's primary list: the real
+    // `/v2/droplets` (no path params) over an id-scoped sub-view that happens to
+    // classify as a list (`/v2/droplets/{id}/destroy_with_associated_resources`),
+    // whose response is NOT the resource's own rows. Fewest path params wins;
+    // stable otherwise (list before search at equal depth).
+    const listish = [...pick(group, "list"), ...pick(group, "search")].sort((a, b) => a.endpoint.parameters.length - b.endpoint.parameters.length);
+    const details = pick(group, "detail");
+    const creates = pick(group, "create");
+    const updates = pick(group, "update");
+    const deletes = pick(group, "delete");
+    const actions = pick(group, "action");
+    // List / search screen — the resource's home.
+    if (listish.length > 0) {
+        screens.push(Object.assign(Object.assign({}, common), { path: base, kind: "list", title: label, primary: listish[0].endpoint, 
+            // extra search variants + the row-action targets (detail/delete) the
+            // list links to.
+            secondary: [...listish.slice(1), ...details, ...deletes] }));
+    }
+    // Detail screen — one entity. Hosts update/delete/action as buttons.
+    if (details.length > 0) {
+        screens.push(Object.assign(Object.assign({}, common), { path: `${base}/[${itemParam(group)}]`, kind: "detail", title: `${label} detail`, primary: details[0].endpoint, secondary: [...updates, ...deletes, ...actions] }));
+    }
+    // Create screen — a form from the POST requestBody schema.
+    if (creates.length > 0) {
+        screens.push(Object.assign(Object.assign({}, common), { path: `${base}/new`, kind: "create", title: `New ${label.toLowerCase()}`, primary: creates[0].endpoint, secondary: [] }));
+    }
+    // Edit screen — a form from the PUT/PATCH requestBody, prefilled by detail.
+    if (updates.length > 0) {
+        screens.push(Object.assign(Object.assign({}, common), { path: `${base}/[${itemParam(group)}]/edit`, kind: "edit", title: `Edit ${label.toLowerCase()}`, primary: updates[0].endpoint, secondary: details }));
+    }
+    return screens;
+}
+function resourcePlan(endpoints, document) {
+    return (0, classifyEndpoints_1.classifyEndpoints)(endpoints, document).flatMap(planResource);
+}
+//# sourceMappingURL=resourcePlan.js.map

package/lib/utils/resourcePlan.js.map

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

package/lib/utils/sliceDocument.d.ts

@@ -0,0 +1,17 @@
+import { OpenApi } from "@typia/interface";
+import { IEndpointFilter } from "./endpointFilter";
+/**
+ * Slice an OpenAPI document down to an operator-selected surface — the fix for
+ * "`--include` only trims the endpoint list, but the SDK Study still compiles
+ * the WHOLE document and overflows the model's context on a large swagger".
+ *
+ * {@link filterEndpoints} answers *which screens*; this answers *which document*.
+ * It keeps only the filtered paths/methods AND prunes `components.schemas` to
+ * the transitive closure those operations actually reference, so every
+ * downstream phase (SDK Study, Product Plan, Render) sees a document whose size
+ * matches the requested slice — not the original 300-type spec.
+ *
+ * Pure: returns a new document; the input is never mutated. A no-op filter
+ * returns an equivalent document (schemas reachable from all operations).
+ */
+export declare function sliceDocument(document: OpenApi.IDocument, filter?: IEndpointFilter): OpenApi.IDocument;

package/lib/utils/sliceDocument.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sliceDocument = sliceDocument;
+const endpointFilter_1 = require("./endpointFilter");
+const toEndpoints_1 = require("./toEndpoints");
+/**
+ * Slice an OpenAPI document down to an operator-selected surface — the fix for
+ * "`--include` only trims the endpoint list, but the SDK Study still compiles
+ * the WHOLE document and overflows the model's context on a large swagger".
+ *
+ * {@link filterEndpoints} answers *which screens*; this answers *which document*.
+ * It keeps only the filtered paths/methods AND prunes `components.schemas` to
+ * the transitive closure those operations actually reference, so every
+ * downstream phase (SDK Study, Product Plan, Render) sees a document whose size
+ * matches the requested slice — not the original 300-type spec.
+ *
+ * Pure: returns a new document; the input is never mutated. A no-op filter
+ * returns an equivalent document (schemas reachable from all operations).
+ */
+function sliceDocument(document, filter = {}) {
+    var _a, _b, _c;
+    const kept = new Set((0, endpointFilter_1.filterEndpoints)((0, toEndpoints_1.toEndpoints)(document), filter).map((e) => `${e.method.toLowerCase()} ${e.path}`));
+    // Rebuild paths, keeping only the (method, path) pairs that survived the
+    // filter. A path with no surviving method is dropped entirely.
+    const paths = {};
+    for (const [path, item] of Object.entries((_a = document.paths) !== null && _a !== void 0 ? _a : {})) {
+        if (item === undefined)
+            continue;
+        const keptItem = {};
+        for (const [key, value] of Object.entries(item)) {
+            // Non-method members of a path item (parameters, $ref, summary…) are
+            // carried over only when at least one method on the path survives.
+            if (!HTTP_METHODS.has(key.toLowerCase()))
+                continue;
+            if (kept.has(`${key.toLowerCase()} ${path}`))
+                keptItem[key] = value;
+        }
+        if (Object.keys(keptItem).length === 0)
+            continue;
+        for (const [key, value] of Object.entries(item)) {
+            if (!HTTP_METHODS.has(key.toLowerCase()))
+                keptItem[key] = value;
+        }
+        paths[path] = keptItem;
+    }
+    // Compute the transitive schema closure reachable from the kept operations.
+    const allSchemas = (_c = (_b = document.components) === null || _b === void 0 ? void 0 : _b.schemas) !== null && _c !== void 0 ? _c : {};
+    const reachable = new Set();
+    const frontier = [];
+    const seed = (schema) => {
+        for (const name of collectRefs(schema)) {
+            if (!reachable.has(name)) {
+                reachable.add(name);
+                frontier.push(name);
+            }
+        }
+    };
+    for (const item of Object.values(paths)) {
+        for (const [key, op] of Object.entries(item !== null && item !== void 0 ? item : {})) {
+            if (!HTTP_METHODS.has(key.toLowerCase()))
+                continue;
+            seed(op);
+        }
+    }
+    while (frontier.length > 0) {
+        const name = frontier.pop();
+        seed(allSchemas[name]);
+    }
+    const schemas = {};
+    for (const name of reachable) {
+        const schema = allSchemas[name];
+        if (schema !== undefined)
+            schemas[name] = schema;
+    }
+    return Object.assign(Object.assign({}, document), { paths, components: Object.assign(Object.assign({}, document.components), { schemas }) });
+}
+const HTTP_METHODS = new Set([
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "head",
+    "options",
+    "trace",
+]);
+/**
+ * Every component name a JSON value references via `$ref`, found by walking the
+ * whole subtree (properties, items, allOf/oneOf/anyOf, additionalProperties,
+ * and arbitrarily nested objects/arrays). Returns bare names (`Sale`), not
+ * pointers.
+ */
+function collectRefs(value) {
+    const out = [];
+    const walk = (node) => {
+        if (node === null || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            for (const child of node)
+                walk(child);
+            return;
+        }
+        const obj = node;
+        const ref = obj.$ref;
+        if (typeof ref === "string" && ref.startsWith("#/components/schemas/")) {
+            out.push(ref.slice("#/components/schemas/".length));
+        }
+        for (const child of Object.values(obj))
+            walk(child);
+    };
+    walk(value);
+    return out;
+}
+//# sourceMappingURL=sliceDocument.js.map

package/lib/utils/sliceDocument.js.map

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

package/lib/utils/toEndpoints.d.ts

@@ -0,0 +1,90 @@
+import { OpenApi } from "@typia/interface";
+/**
+ * Swagger-native endpoint model — Step toward "swagger만 읽고 정확하게".
+ *
+ * Built directly from nestia's `HttpMigration.application(doc).routes`, the
+ * single source of truth that already carries accessor + query + path params +
+ * body + response for EVERY operation. Replaces the former
+ * `invertOpenApiDocument`, whose `r.query === null` filter silently dropped
+ * every query-string endpoint (search / filter / pagination) — see the bug
+ * this migration fixes.
+ *
+ * Shape mirrors the former endpoint model so the orchestrators change minimally
+ * (`document.operations` → `toEndpoints(document)`), plus the one field the old
+ * model could not express: {@link IAutoViewEndpoint.query}.
+ *
+ * Schemas are typed as `OpenApi.IJsonSchema` purely for structural reuse
+ * — at runtime they ARE standard OpenAPI schemas (the old invert did the same
+ * `as any` cast), so the existing `describeEndpoint*` / `renderJsonSchema`
+ * helpers keep working unchanged.
+ */
+export interface IAutoViewEndpoint {
+    method: string;
+    path: string;
+    /** SDK function path nestia assigns, e.g. `["items","search","get"]`. */
+    accessor: string[];
+    /** Last accessor segment — the SDK function name. */
+    name: string;
+    /** Human description (summary + description merged). */
+    description: string;
+    /** Path parameters (primitive). */
+    parameters: IAutoViewEndpoint.IParameter[];
+    /**
+     * Query-string schema as a single object, or `null` when the endpoint has no
+     * query. THIS is what the old AutoBE model could not hold.
+     */
+    query: OpenApi.IJsonSchema | null;
+    /** Request body reference, or `null`. */
+    requestBody: IAutoViewEndpoint.IBody | null;
+    /** Response body reference, or `null`. */
+    responseBody: IAutoViewEndpoint.IBody | null;
+    /**
+     * The raw success response schema, captured even when {@link responseBody} is
+     * `null` because the response is an INLINE object (not a named `$ref`) — e.g.
+     * DigitalOcean's `{ databases: [...] }`. Lets the consumability analysis
+     * introspect inline collection responses without changing the frontend path
+     * (which keys off the named {@link responseBody.typeName}).
+     */
+    responseSchema: OpenApi.IJsonSchema | null;
+}
+export declare namespace IAutoViewEndpoint {
+    interface IParameter {
+        name: string;
+        description: string;
+        schema: OpenApi.IJsonSchema;
+    }
+    interface IBody {
+        description: string;
+        /**
+         * Component schema name. For an array response (`Pet[]`) this is the
+         * ELEMENT type (`Pet`) with {@link isArray} set — so a list screen knows
+         * its row type and can derive table columns deterministically.
+         */
+        typeName: string;
+        /** True when the payload is an array of `typeName` (list response). */
+        isArray: boolean;
+    }
+}
+/**
+ * True when every accessor segment is a valid JS identifier, so the generator
+ * can emit `api.functional.<a>.<b>(…)`. Some real swaggers (Box) use `#`
+ * fragments in their paths (`/shared_items#folders`, `/schema#add`), which
+ * nestia turns into accessor segments containing `#` — unusable as a dotted
+ * property and a hard syntax error in the generated TSX. Such operations are
+ * dropped from {@link toEndpoints} and surfaced by {@link unsupportedOperations}.
+ */
+export declare function isRenderableAccessor(accessor: string[]): boolean;
+export declare function toEndpoints(document: OpenApi.IDocument): IAutoViewEndpoint[];
+/**
+ * Operations `HttpMigration` could not turn into a route at all — typically an
+ * unsupported request/response content type (e.g. `application/octet-stream`,
+ * raw binary upload/download). These never reach {@link toEndpoints}, so
+ * surfacing them is the only way to keep the READ layer from dropping
+ * endpoints silently.
+ */
+export interface IUnsupportedOperation {
+    method: string;
+    path: string;
+    reason: string;
+}
+export declare function unsupportedOperations(document: OpenApi.IDocument): IUnsupportedOperation[];