@descryy/adapter-python 0.2.0 → 0.3.1

package/dist/routes.d.ts

@@ -1,72 +1,42 @@
 /**
  * The HTTP-route framework extractor for Python — FastAPI, Flask and Django.
+ * `adapter-openapi` reads a published contract, but most repositories
+ * publish none; FastAPI/Flask/Django all declare routes in source (a
+ * decorator with method + path template, or a `urlpatterns` list), so
+ * reading the declaration is not inference.
  *
- * **An `API_ROUTE` is a framework claim, and this file is where it is earned.**
- * Until now the only producer of a route in this project was `adapter-openapi`,
- * reading a published contract. That is the right first move — *if the framework
- * will tell you, never infer it* — but a repository that publishes no contract
- * has no route side of the join at all, and most repositories publish nothing.
- * FastAPI, Flask and Django all *declare* their routes in source: a decorator
- * carrying a method and a path template, or a `urlpatterns` list. Reading a
- * declaration is not inference.
- *
- * ## The rule that does all the precision work
- *
- * **A route is admitted only when its receiver resolves to a router or
- * application constructed from a web framework's own module.** Never because an
- * attribute happens to be spelled like an HTTP verb.
- *
- * That is not a theoretical guard. Matching `@x.get`/`@x.post`/`@x.patch` by
- * name alone, measured before this file was written:
+ * The precision rule: a route is admitted only when its receiver resolves
+ * to a router/application constructed from a web framework's own module,
+ * never because an attribute is spelled like an HTTP verb. Measured before
+ * this file existed, name-only matching of `@x.get`/`@x.post`/`@x.patch`:
  *
  * | repository | verb-named decorators | actually routes |
  * | --- | --- | --- |
- * | django | 171 `@mock.patch` | **0** |
- * | saleor | 1,150 `@mock.patch` | **0** |
- * | dispatch | 1 `@app.options` on a Slack Bolt app | **0** |
- *
- * `unittest.mock.patch` is spelled exactly like the HTTP verb, and on saleor a
- * name rule would have invented 1,150 routes — every one of them a false claim
- * about a URL that does not exist. Slack Bolt's `app.options()` registers an
- * *action id*, not a path. This is golden pattern 12's lesson and §4 rule 3: a
- * node type comes from provenance — an import, a decorator, a base class — or
- * from nothing.
- *
- * ## Everything below the receiver check is arithmetic on written strings
- *
- * A served path is a router's mount prefix chain plus the path at the decorator.
- * On dispatch that chain is four hops and crosses files under import aliases:
- *
- *     app.mount("/api/v1", app=api)                        # main.py
- *     api.include_router(api_router)                       # main.py
- *     api_router.include_router(auth_router, prefix=...)   # api.py, aliased
- *     @auth_router.get("/me")                              # auth/views.py
- *
- * **Every hop of that chain must be followed or the answer is wrong in a way
- * that reads as right.** Dropping the outermost hop yields `/{organization}/…`
- * instead of `/api/v1/{organization}/…`: a plausible path, no error, no ledger
- * row — and a caller that resolved its base URL to `/api/v1` (DEC-052 followed
- * exactly that, three symbol hops on the consumer side) mints a different
- * endpoint id and joins nothing. That is DEC-055's failure mode: everything
- * normalises, everything resolves, and the join count is silently zero.
- *
- * ## Where the line is
- *
- * A prefix or path written as anything but a literal is **disclosed, never
- * guessed**. Emitting a route for a path built at runtime attaches a caller to
- * an endpoint that does not exist, and unlike a missing edge nothing downstream
- * can tell that from a correct one.
- *
- * The split with `extract.py` is this adapter's standing one: the Python side
- * records syntactic form and names no framework, and every decision about what
- * a form *means* is taken here.
+ * | django | 171 `@mock.patch` | 0 |
+ * | saleor | 1,150 `@mock.patch` | 0 |
+ * | dispatch | 1 `@app.options` (Slack Bolt) | 0 |
+ *
+ * Golden pattern 12's lesson: a node type comes from provenance or nothing.
+ *
+ * Everything below the receiver check is arithmetic on written strings: a
+ * served path is the mount prefix chain plus the decorator's path, and
+ * every hop must be followed — dropping one yields a plausible wrong path
+ * with no error and no ledger row, and a caller resolving its own base URL
+ * (DEC-052) would mint a different endpoint id and silently join nothing
+ * (DEC-055's failure mode). A prefix or path written as anything but a
+ * literal is disclosed, never guessed, since a runtime-built path attaches
+ * a caller to an endpoint that doesn't exist and nothing downstream can
+ * tell that from a correct edge.
+ *
+ * `extract.py` records syntactic form and names no framework; every
+ * "what does this form mean" decision is taken here.
  */
 import type { PyCall } from "./extract.ts";
 export type RouteFramework = "fastapi" | "flask" | "django";
 /**
- * The constructors that make a receiver a router, and the modules they must
- * come from. The module check is the precision control: a local class called
- * `Blueprint` is not Flask's, and matching the bare name would admit it.
+ * Constructors that make a receiver a router, and the modules they must come
+ * from — a local class called `Blueprint` is not Flask's, and a bare-name
+ * match would admit it.
  */
 export declare const ROUTER_CONSTRUCTORS: Readonly<Record<RouteFramework, Readonly<Record<string, ReadonlySet<string>>>>>;
 /** `django.urls.path`/`re_path`/`url`, and `include` for a nested urlconf. */
@@ -92,12 +62,9 @@ export interface RouterDecl {
     readonly line: number;
 }
 /**
- * Is this the application itself rather than a router that must be mounted?
- *
- * The distinction decides whether "nothing mounts this" is a disclosure or a
- * non-event. `FastAPI()` and `Flask()` are roots and serve their routes at the
- * paths written on them. An `APIRouter` or a `Blueprint` that nothing mounts
- * serves nothing at all, and the path it would serve is genuinely unknowable.
+ * Is this the application itself, not a router that must be mounted? Decides
+ * whether "nothing mounts this" is a disclosure or a non-event — `FastAPI()`/
+ * `Flask()` are roots; an unmounted `APIRouter`/`Blueprint` serves nothing.
  */
 export declare function isApplicationRouter(router: RouterDecl): boolean;
 /** One router mounted inside another. */
@@ -134,19 +101,16 @@ export declare function frameworkOfConstructor(callee: string, moduleOfImport: (
 } | null;
 /**
  * Routers declared in one file, by the local name that holds them.
- *
- * `moduleOfImport` answers "which module did this name come from", which is the
- * only thing separating Flask's `Blueprint` from a class of the same name.
+ * `moduleOfImport` is the only thing separating Flask's `Blueprint` from a
+ * class of the same name.
  */
 export declare function routersIn(file: string, calls: readonly PyCall[], assignedLocal: (call: PyCall) => string | undefined, moduleOfImport: (name: string) => string | undefined): RouterDecl[];
 /** Mounts declared in one file. */
 export declare function mountsIn(file: string, calls: readonly PyCall[]): RouterMount[];
 /**
- * Route declarations from one decorator call.
- *
- * Returns `null` when the decorator is not a route at all. The receiver is
- * *not* checked here — the caller does that against the resolved router table,
- * because whether `app` is a Flask application or a Slack Bolt one cannot be
+ * Route declarations from one decorator call, or `null` when it's not a
+ * route. The receiver is not checked here — the caller does that against the
+ * resolved router table, since whether `app` is Flask or Slack Bolt can't be
  * decided from this file alone.
  */
 export declare function routeFromDecorator(file: string, call: PyCall, handler: readonly string[] | null): RouteDecl | null;
@@ -167,29 +131,29 @@ export declare function odooRouteFromDecorator(file: string, call: PyCall, handl
 export declare const DRF_ROUTER_CONSTRUCTORS: ReadonlySet<string>;
 /**
  * DRF's fixed action table — what `DefaultRouter`/`SimpleRouter` always
- * generate for a registered viewset, unconditionally. This is the router's
- * own documented contract, not an inference about which actions a viewset
- * implements: an unimplemented action still gets the URL, and 405s at
- * request time. Reading the contract rather than the implementation is the
- * same trade this file already makes for Flask's undecorated `.route()`
- * default (`GENERIC_ROUTE_ATTRS`, above).
+ * generate for a registered viewset, unconditionally (the router's own
+ * documented contract, not an inference; an unimplemented action still
+ * gets the URL and 405s at request time).
+ *
+ * `action` is the viewset method name DRF's own dispatch calls for it — the
+ * same name a subclass would override. Most `ModelViewSet` registrations
+ * never write these in source at all (they come from DRF's own installed
+ * mixins), so resolving `action` to a same-file declaration is expected to
+ * miss far more often than it hits; a viewset that *does* override one is
+ * exactly the case worth naming.
  */
 export declare const DRF_ACTIONS: readonly {
     readonly method: string;
     readonly suffix: string;
+    readonly action: string;
 }[];
 export declare function djangoUrlFunctionOf(callee: string, moduleOfImport: (name: string) => string | undefined): string | null;
 /**
  * `re_path`/`url` write a param as `(?P<name>...)`, not `<type:name>`.
- *
- * Translating an arbitrary regex into a path template is not attempted —
- * that is the same guess `templateOfSource` in `client.ts` refuses to make
- * for a call path, for the same reason. What is read: the anchors (`^`/`$`,
- * which every Django regex route carries and which are not part of the
- * served path), and a named group, which names its own placeholder and
- * needs no interpretation. Anything else regex-shaped left afterwards —
- * an unnamed group, a character class, a quantifier on a literal segment —
- * means the pattern is refused rather than approximated.
+ * Translating an arbitrary regex into a template isn't attempted — the same
+ * guess `client.ts`'s `templateOfSource` refuses. Reads only the anchors
+ * (`^`/`$`, not part of the served path) and named groups; anything else
+ * regex-shaped left afterwards means the pattern is refused, not approximated.
  */
 export declare function djangoRegexPathOf(raw: string): string | null;
 /** One `path()`/`re_path()`/`url()` call, read but not yet chain-resolved. */
@@ -239,11 +203,8 @@ export declare function drfRouterLocalsIn(calls: readonly PyCall[], localOfCall:
 /** Every `.register(...)` call on a receiver, whether or not it is a DRF router — the caller filters. */
 export declare function drfRegisterCallsIn(file: string, calls: readonly PyCall[]): DrfRegisterEntry[];
 /**
- * Join a mount prefix to a route path.
- *
- * Frameworks are lenient about the slash between the two and repositories write
- * both forms; the served path is the same either way, and two spellings of one
- * path must not become two endpoints.
+ * Join a mount prefix to a route path. Frameworks are lenient about the
+ * slash between the two, and two spellings of one path must not become two endpoints.
  */
 export declare function joinPath(prefix: string, path: string): string;
 //# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

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

package/dist/routes.js

@@ -1,70 +1,40 @@
 /**
  * The HTTP-route framework extractor for Python — FastAPI, Flask and Django.
+ * `adapter-openapi` reads a published contract, but most repositories
+ * publish none; FastAPI/Flask/Django all declare routes in source (a
+ * decorator with method + path template, or a `urlpatterns` list), so
+ * reading the declaration is not inference.
  *
- * **An `API_ROUTE` is a framework claim, and this file is where it is earned.**
- * Until now the only producer of a route in this project was `adapter-openapi`,
- * reading a published contract. That is the right first move — *if the framework
- * will tell you, never infer it* — but a repository that publishes no contract
- * has no route side of the join at all, and most repositories publish nothing.
- * FastAPI, Flask and Django all *declare* their routes in source: a decorator
- * carrying a method and a path template, or a `urlpatterns` list. Reading a
- * declaration is not inference.
- *
- * ## The rule that does all the precision work
- *
- * **A route is admitted only when its receiver resolves to a router or
- * application constructed from a web framework's own module.** Never because an
- * attribute happens to be spelled like an HTTP verb.
- *
- * That is not a theoretical guard. Matching `@x.get`/`@x.post`/`@x.patch` by
- * name alone, measured before this file was written:
+ * The precision rule: a route is admitted only when its receiver resolves
+ * to a router/application constructed from a web framework's own module,
+ * never because an attribute is spelled like an HTTP verb. Measured before
+ * this file existed, name-only matching of `@x.get`/`@x.post`/`@x.patch`:
  *
  * | repository | verb-named decorators | actually routes |
  * | --- | --- | --- |
- * | django | 171 `@mock.patch` | **0** |
- * | saleor | 1,150 `@mock.patch` | **0** |
- * | dispatch | 1 `@app.options` on a Slack Bolt app | **0** |
- *
- * `unittest.mock.patch` is spelled exactly like the HTTP verb, and on saleor a
- * name rule would have invented 1,150 routes — every one of them a false claim
- * about a URL that does not exist. Slack Bolt's `app.options()` registers an
- * *action id*, not a path. This is golden pattern 12's lesson and §4 rule 3: a
- * node type comes from provenance — an import, a decorator, a base class — or
- * from nothing.
- *
- * ## Everything below the receiver check is arithmetic on written strings
- *
- * A served path is a router's mount prefix chain plus the path at the decorator.
- * On dispatch that chain is four hops and crosses files under import aliases:
- *
- *     app.mount("/api/v1", app=api)                        # main.py
- *     api.include_router(api_router)                       # main.py
- *     api_router.include_router(auth_router, prefix=...)   # api.py, aliased
- *     @auth_router.get("/me")                              # auth/views.py
+ * | django | 171 `@mock.patch` | 0 |
+ * | saleor | 1,150 `@mock.patch` | 0 |
+ * | dispatch | 1 `@app.options` (Slack Bolt) | 0 |
  *
- * **Every hop of that chain must be followed or the answer is wrong in a way
- * that reads as right.** Dropping the outermost hop yields `/{organization}/…`
- * instead of `/api/v1/{organization}/…`: a plausible path, no error, no ledger
- * row — and a caller that resolved its base URL to `/api/v1` (DEC-052 followed
- * exactly that, three symbol hops on the consumer side) mints a different
- * endpoint id and joins nothing. That is DEC-055's failure mode: everything
- * normalises, everything resolves, and the join count is silently zero.
+ * Golden pattern 12's lesson: a node type comes from provenance or nothing.
  *
- * ## Where the line is
+ * Everything below the receiver check is arithmetic on written strings: a
+ * served path is the mount prefix chain plus the decorator's path, and
+ * every hop must be followed — dropping one yields a plausible wrong path
+ * with no error and no ledger row, and a caller resolving its own base URL
+ * (DEC-052) would mint a different endpoint id and silently join nothing
+ * (DEC-055's failure mode). A prefix or path written as anything but a
+ * literal is disclosed, never guessed, since a runtime-built path attaches
+ * a caller to an endpoint that doesn't exist and nothing downstream can
+ * tell that from a correct edge.
  *
- * A prefix or path written as anything but a literal is **disclosed, never
- * guessed**. Emitting a route for a path built at runtime attaches a caller to
- * an endpoint that does not exist, and unlike a missing edge nothing downstream
- * can tell that from a correct one.
- *
- * The split with `extract.py` is this adapter's standing one: the Python side
- * records syntactic form and names no framework, and every decision about what
- * a form *means* is taken here.
+ * `extract.py` records syntactic form and names no framework; every
+ * "what does this form mean" decision is taken here.
  */
 /**
- * The constructors that make a receiver a router, and the modules they must
- * come from. The module check is the precision control: a local class called
- * `Blueprint` is not Flask's, and matching the bare name would admit it.
+ * Constructors that make a receiver a router, and the modules they must come
+ * from — a local class called `Blueprint` is not Flask's, and a bare-name
+ * match would admit it.
  */
 export const ROUTER_CONSTRUCTORS = {
     fastapi: {
@@ -111,12 +81,9 @@ export const MOUNT_ATTRS = new Set([
     "mount",
 ]);
 /**
- * Is this the application itself rather than a router that must be mounted?
- *
- * The distinction decides whether "nothing mounts this" is a disclosure or a
- * non-event. `FastAPI()` and `Flask()` are roots and serve their routes at the
- * paths written on them. An `APIRouter` or a `Blueprint` that nothing mounts
- * serves nothing at all, and the path it would serve is genuinely unknowable.
+ * Is this the application itself, not a router that must be mounted? Decides
+ * whether "nothing mounts this" is a disclosure or a non-event — `FastAPI()`/
+ * `Flask()` are roots; an unmounted `APIRouter`/`Blueprint` serves nothing.
  */
 export function isApplicationRouter(router) {
     return router.constructor === "FastAPI" || router.constructor === "Flask";
@@ -129,17 +96,15 @@ export function frameworkOfConstructor(callee, moduleOfImport) {
         const modules = table[leaf];
         if (modules === undefined)
             continue;
-        // A dotted callee names its module at the call site; a bare one was
-        // imported, and the import table says from where. Either way the module is
-        // checked — this is the whole precision control and it is never skipped.
+        // Dotted callee names its module at the call site; bare one was
+        // imported. Either way the module is checked — never skipped.
         const written = callee.includes(".") ? callee.slice(0, callee.lastIndexOf(".")) : undefined;
         const imported = moduleOfImport(callee.split(".")[0]);
         const module = written !== undefined && written.includes(".") ? written : imported;
         if (module !== undefined && modules.has(module)) {
             return { framework: framework, constructor: leaf };
         }
-        // A bare `APIRouter()` whose import resolved to the framework's package
-        // rather than to the exact submodule.
+        // A bare `APIRouter()` whose import resolved to the package, not the exact submodule.
         if (imported !== undefined && [...modules].some((m) => imported === m || imported.startsWith(`${m}.`))) {
             return { framework: framework, constructor: leaf };
         }
@@ -159,9 +124,8 @@ function prefixOf(call, keys) {
 }
 /**
  * Routers declared in one file, by the local name that holds them.
- *
- * `moduleOfImport` answers "which module did this name come from", which is the
- * only thing separating Flask's `Blueprint` from a class of the same name.
+ * `moduleOfImport` is the only thing separating Flask's `Blueprint` from a
+ * class of the same name.
  */
 export function routersIn(file, calls, assignedLocal, moduleOfImport) {
     const out = [];
@@ -194,8 +158,8 @@ export function mountsIn(file, calls) {
         if (call.receiver === null)
             continue;
         if (call.attribute === "mount") {
-            // `app.mount("/api/v1", app=sub)` — Starlette. The prefix is positional
-            // and the child is a keyword or the second positional.
+            // `app.mount("/api/v1", app=sub)` — Starlette: positional prefix, child
+            // as keyword or second positional.
             const prefix = typeof call.literals[0] === "string"
                 ? call.literals[0]
                 : call.args.length > 0
@@ -207,11 +171,9 @@ export function mountsIn(file, calls) {
             out.push({ file, scope: call.scope, parentLocal: call.receiver, childLocal: child, prefix, line: call.line });
             continue;
         }
-        // `app.register_blueprint(auth.bp)` is as common as the bare-name form and
-        // was invisible while only `argNames` was read — `argNames` is null for an
-        // attribute. The dotted text is kept and the caller resolves the module
-        // half through its import table; dropping it disclosed real, registered
-        // blueprints as never mounted.
+        // `app.register_blueprint(auth.bp)` is as common as the bare-name form
+        // but was invisible reading only `argNames` (null for an attribute) —
+        // dropping it disclosed real, registered blueprints as never mounted.
         const child = call.argNames[0] ??
             call.keywordNames["router"] ??
             call.keywordNames["blueprint"] ??
@@ -230,11 +192,9 @@ export function mountsIn(file, calls) {
     return out;
 }
 /**
- * Route declarations from one decorator call.
- *
- * Returns `null` when the decorator is not a route at all. The receiver is
- * *not* checked here — the caller does that against the resolved router table,
- * because whether `app` is a Flask application or a Slack Bolt one cannot be
+ * Route declarations from one decorator call, or `null` when it's not a
+ * route. The receiver is not checked here — the caller does that against the
+ * resolved router table, since whether `app` is Flask or Slack Bolt can't be
  * decided from this file alone.
  */
 export function routeFromDecorator(file, call, handler) {
@@ -250,14 +210,13 @@ export function routeFromDecorator(file, call, handler) {
             methods = written.filter((m) => typeof m === "string").map((m) => m.toUpperCase());
         }
         else if (call.opaqueKeywords.includes("methods")) {
-            // The verbs are written and this reader cannot read them. Defaulting to
-            // GET here would report the opposite of the source as fact — the same
-            // mistake `nullable=FLAG` exists to prevent on the ORM side.
+            // Verbs are written but unreadable; defaulting to GET would report the
+            // opposite of the source as fact.
             return null;
         }
         else {
-            // Flask's documented default, and FastAPI's `api_route` requires the
-            // keyword, so an absent one there means this is not a route to read.
+            // Flask's documented default; FastAPI's `api_route` requires the
+            // keyword, so an absent one means this isn't a route to read.
             methods = ["GET"];
         }
     }
@@ -282,16 +241,10 @@ export function routeFromDecorator(file, call, handler) {
         responseModel: call.keywordText["response_model"] ?? null,
     };
 }
-// ---------------------------------------------------------------------------
 // Odoo — `@http.route(path, methods=[...])`, always on a `Controller`
-// subclass's own method.
-//
-// **Simpler than FastAPI/Flask, not harder.** There is no router object and
-// no mount chain: Odoo controllers write the full absolute path directly in
-// every `@http.route(...)` call, so once the decorator's provenance is
-// verified against `odoo.http` there is nothing left to resolve — the path
-// on the decorator IS the served path.
-// ---------------------------------------------------------------------------
+// subclass's method. Simpler than FastAPI/Flask: no router object, no mount
+// chain — the full absolute path is written directly, so once provenance is
+// verified against `odoo.http` the decorator's path IS the served path.
 const ODOO_HTTP_MODULES = new Set(["odoo.http", "odoo.addons.http"]);
 /** `@http.route(...)` / `@route(...)`, verified against `odoo.http`. */
 export function odooRouteFromDecorator(file, call, handler, moduleOfImport) {
@@ -319,19 +272,13 @@ export function odooRouteFromDecorator(file, call, handler, moduleOfImport) {
             : ["GET"]; // Odoo's own documented default when the keyword is absent
     return { file, scope: call.scope, path: literal, rawPath: raw, methods, line: call.line, handler };
 }
-// ---------------------------------------------------------------------------
-// Django's own routing — `urlpatterns`/`path()`/`re_path()`/`url()`, and DRF's
-// `router.register(...)`.
-//
-// **Architecturally different from FastAPI/Flask, which is why it is not a
-// case of `ROUTER_CONSTRUCTORS.django`.** There is no router object: `path()`
-// is a bare function, verified by where it was imported from rather than by
-// what it was constructed from, and a file's `urlpatterns` list is the
-// router — identified by its own module path, not by a local variable name,
-// because `include("myapp.urls")` names a MODULE, never a local. The prefix
-// chain this earns is walked the same way FastAPI's mount chain is (one
-// `include()` hop at a time), just keyed differently.
-// ---------------------------------------------------------------------------
+// Django's own routing — `urlpatterns`/`path()`/`re_path()`/`url()`, and
+// DRF's `router.register(...)`. Architecturally different from FastAPI/Flask
+// (not a case of `ROUTER_CONSTRUCTORS.django`): no router object, `path()`
+// is a bare function verified by import provenance, and a file's
+// `urlpatterns` list is identified by its module path since
+// `include("myapp.urls")` names a module, never a local. The prefix chain
+// walks the same way as FastAPI's mount chain, just keyed differently.
 /** `path`, `re_path` and the pre-2.0 alias `url` — all three read a route the same way. */
 const DJANGO_URL_FUNCTIONS = new Set(["path", "re_path", "url"]);
 /** `include(...)`, always from `django.urls`. */
@@ -343,20 +290,24 @@ export const DRF_ROUTER_CONSTRUCTORS = new Set([
 ]);
 /**
  * DRF's fixed action table — what `DefaultRouter`/`SimpleRouter` always
- * generate for a registered viewset, unconditionally. This is the router's
- * own documented contract, not an inference about which actions a viewset
- * implements: an unimplemented action still gets the URL, and 405s at
- * request time. Reading the contract rather than the implementation is the
- * same trade this file already makes for Flask's undecorated `.route()`
- * default (`GENERIC_ROUTE_ATTRS`, above).
+ * generate for a registered viewset, unconditionally (the router's own
+ * documented contract, not an inference; an unimplemented action still
+ * gets the URL and 405s at request time).
+ *
+ * `action` is the viewset method name DRF's own dispatch calls for it — the
+ * same name a subclass would override. Most `ModelViewSet` registrations
+ * never write these in source at all (they come from DRF's own installed
+ * mixins), so resolving `action` to a same-file declaration is expected to
+ * miss far more often than it hits; a viewset that *does* override one is
+ * exactly the case worth naming.
  */
 export const DRF_ACTIONS = [
-    { method: "GET", suffix: "" },
-    { method: "POST", suffix: "" },
-    { method: "GET", suffix: "{param}" },
-    { method: "PUT", suffix: "{param}" },
-    { method: "PATCH", suffix: "{param}" },
-    { method: "DELETE", suffix: "{param}" },
+    { method: "GET", suffix: "", action: "list" },
+    { method: "POST", suffix: "", action: "create" },
+    { method: "GET", suffix: "{param}", action: "retrieve" },
+    { method: "PUT", suffix: "{param}", action: "update" },
+    { method: "PATCH", suffix: "{param}", action: "partial_update" },
+    { method: "DELETE", suffix: "{param}", action: "destroy" },
 ];
 /** Which Django URL-module function a callee names, verified by provenance — mirrors `frameworkOfConstructor`. */
 function djangoModuleFunctionOf(callee, names, moduleOfImport) {
@@ -379,15 +330,10 @@ export function djangoUrlFunctionOf(callee, moduleOfImport) {
 }
 /**
  * `re_path`/`url` write a param as `(?P<name>...)`, not `<type:name>`.
- *
- * Translating an arbitrary regex into a path template is not attempted —
- * that is the same guess `templateOfSource` in `client.ts` refuses to make
- * for a call path, for the same reason. What is read: the anchors (`^`/`$`,
- * which every Django regex route carries and which are not part of the
- * served path), and a named group, which names its own placeholder and
- * needs no interpretation. Anything else regex-shaped left afterwards —
- * an unnamed group, a character class, a quantifier on a literal segment —
- * means the pattern is refused rather than approximated.
+ * Translating an arbitrary regex into a template isn't attempted — the same
+ * guess `client.ts`'s `templateOfSource` refuses. Reads only the anchors
+ * (`^`/`$`, not part of the served path) and named groups; anything else
+ * regex-shaped left afterwards means the pattern is refused, not approximated.
  */
 export function djangoRegexPathOf(raw) {
     let pattern = raw;
@@ -494,11 +440,8 @@ export function drfRegisterCallsIn(file, calls) {
     return out;
 }
 /**
- * Join a mount prefix to a route path.
- *
- * Frameworks are lenient about the slash between the two and repositories write
- * both forms; the served path is the same either way, and two spellings of one
- * path must not become two endpoints.
+ * Join a mount prefix to a route path. Frameworks are lenient about the
+ * slash between the two, and two spellings of one path must not become two endpoints.
  */
 export function joinPath(prefix, path) {
     const left = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;