@kensio/yulin 1.16.2 → 1.17.0

package/dist/serve/http/api/query/sim-query-request.js

@@ -0,0 +1,136 @@
+/**
+ * Read a request as the Query protocol operation it names.
+ *
+ * Returns undefined when no `Action` is stated, which is what separates a
+ * Query request from anything else that reached the endpoint.
+ */
+export function readSimQueryRequest(request, body) {
+    const fields = queryFields(request, body);
+    const action = fields.get("Action");
+    return action === null || action.length === 0
+        ? undefined
+        : { action, fields: new SimQueryFields(fields) };
+}
+/**
+ * The fields of one Query request, or of one structure inside it.
+ *
+ * Query has no nesting on the wire. A structure states its members under a
+ * dotted prefix, a list repeats a numbered `member` segment and a map repeats
+ * a numbered `entry` segment, so `Tags.member.2.Key` is the key of the second
+ * tag. Reading that back is a matter of knowing which prefix is in play, and an
+ * instance of this holds one. The whole request is the empty prefix, and each
+ * list member or map entry is the same fields under a longer one.
+ */
+export class SimQueryFields {
+    fields;
+    prefix;
+    constructor(fields, prefix = "") {
+        this.fields = fields;
+        this.prefix = prefix;
+    }
+    /**
+     * One string member, or nothing when the request did not state it.
+     */
+    text(name) {
+        return this.fields.get(`${this.prefix}${name}`) ?? undefined;
+    }
+    /**
+     * One boolean member, which Query spells out as `true` or `false`.
+     */
+    flag(name) {
+        const value = this.text(name);
+        return value === undefined ? undefined : value === "true";
+    }
+    /**
+     * One numeric member, which Query carries as its decimal text.
+     *
+     * Text that is not a number at all is nothing rather than NaN, so a
+     * simulated service sees a member the request never stated instead of a
+     * value it has to check.
+     */
+    number(name) {
+        const value = this.text(name);
+        if (value === undefined || value.trim().length === 0) {
+            return undefined;
+        }
+        const parsed = Number(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    /**
+     * One blob member, which Query carries as base64 text.
+     */
+    binary(name) {
+        const value = this.text(name);
+        return value === undefined ? undefined : Buffer.from(value, "base64");
+    }
+    /**
+     * The members of a list, read one at a time from the fields under each
+     * subscript.
+     *
+     * A list nobody stated is nothing rather than an empty list. The two are
+     * different requests, and a simulated service refusing a member it does not
+     * implement has to tell a request that omitted it from one that sent it
+     * empty.
+     */
+    list(name, read) {
+        const members = this.subscripts(name, "member");
+        return members.length === 0 ? undefined : members.map(read);
+    }
+    /**
+     * The entries of a map, each as the fields under its own subscript.
+     */
+    entries(name) {
+        return this.subscripts(name, "entry");
+    }
+    /**
+     * A map of strings to strings, which is the shape every attribute member of
+     * a Query request has.
+     *
+     * An entry stating no key is dropped rather than held under an empty one,
+     * since there is no attribute it could be naming.
+     */
+    attributes(name) {
+        const entries = this.entries(name);
+        if (entries.length === 0) {
+            return undefined;
+        }
+        const named = entries
+            .map((entry) => ({ key: entry.text("key"), value: entry.text("value") }))
+            .filter((entry) => entry.key !== undefined && entry.key.length > 0);
+        return Object.fromEntries(named.map((entry) => [entry.key ?? "", entry.value ?? ""]));
+    }
+    /**
+     * The subscripted prefixes a list or a map states under this one.
+     *
+     * The subscripts are read off the field names rather than counted up from
+     * one, because a request that skips a number is still a request, and they
+     * are ordered numerically so the list arrives in the order it was written
+     * rather than the order the form encoding happens to carry.
+     */
+    subscripts(name, wrapper) {
+        const start = `${this.prefix}${name}.${wrapper}.`;
+        const subscripts = new Set();
+        for (const field of this.fields.keys()) {
+            if (field.startsWith(start)) {
+                subscripts.add(field.slice(start.length).split(".", 1)[0] ?? "");
+            }
+        }
+        return [...subscripts]
+            .toSorted((one, other) => Number(one) - Number(other))
+            .map((subscript) => new SimQueryFields(this.fields, `${start}${subscript}.`));
+    }
+}
+/**
+ * The form-encoded fields a request carried, wherever it put them.
+ *
+ * A POST carries them in the body and a GET in the query string, and the
+ * `aws` CLI sends a POST while a browser or a hand-written GET sends the
+ * other. Both are read so that neither has to be the supported one.
+ */
+function queryFields(request, body) {
+    if (body.byteLength > 0) {
+        return new URLSearchParams(Buffer.from(body).toString("utf8"));
+    }
+    return new URL(request.url).searchParams;
+}
+//# sourceMappingURL=sim-query-request.js.map

package/dist/serve/http/api/query/sim-query-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-query-request.js","sourceRoot":"","sources":["../../../../../src/serve/http/api/query/sim-query-request.ts"],"names":[],"mappings":"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"}

package/dist/serve/http/api/query/sim-query-response.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Writes the responses of one Query protocol service.
+ *
+ * Every Query response has the same shape: `<XResponse><XResult>...</XResult>`
+ * and a `ResponseMetadata` holding the request id. An SDK reads the operation's
+ * output out of the inner element, so the envelope carries the operation name
+ * rather than a generic one.
+ *
+ * What differs between services is the XML namespace stamped on the envelope,
+ * and each states its own. A client parses either way, since it reads the
+ * elements by name, so this is fidelity rather than something a caller depends
+ * on.
+ */
+export declare class SimQueryProtocol {
+    private readonly namespace;
+    constructor(namespace: string);
+    /**
+     * Answer an operation with the result members it produced.
+     */
+    response(action: string, result: string): Response;
+    /**
+     * Refuse a request by name, in the shape an SDK reads an error out of.
+     */
+    error(status: number, code: string, message: string): Response;
+    /**
+     * Report what a simulated operation threw.
+     *
+     * A simulated service error already carries the AWS exception name and the
+     * status real AWS answers with, so an SDK raises it under the name a handler
+     * catching it in production would see.
+     */
+    failure(error: unknown): Response;
+    private xml;
+}
+//# sourceMappingURL=sim-query-response.d.ts.map

package/dist/serve/http/api/query/sim-query-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-query-response.d.ts","sourceRoot":"","sources":["../../../../../src/serve/http/api/query/sim-query-response.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAWjD;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAc7D;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAKhC;IAED,OAAO,CAAC,GAAG;CAUZ"}

package/dist/serve/http/api/query/sim-query-response.js

@@ -0,0 +1,63 @@
+import { escapeXmlText, xmlElement, xmlValue, } from "../../../../util/xml/xml-writer.js";
+import { simSdkWireErrorStatusCode } from "../../../../sdk/wire/sim-sdk-wire-response.js";
+/**
+ * A request id, which every Query response carries and nothing reads back.
+ */
+const simQueryRequestId = "00000000-0000-0000-0000-000000000000";
+/**
+ * Writes the responses of one Query protocol service.
+ *
+ * Every Query response has the same shape: `<XResponse><XResult>...</XResult>`
+ * and a `ResponseMetadata` holding the request id. An SDK reads the operation's
+ * output out of the inner element, so the envelope carries the operation name
+ * rather than a generic one.
+ *
+ * What differs between services is the XML namespace stamped on the envelope,
+ * and each states its own. A client parses either way, since it reads the
+ * elements by name, so this is fidelity rather than something a caller depends
+ * on.
+ */
+export class SimQueryProtocol {
+    namespace;
+    constructor(namespace) {
+        this.namespace = namespace;
+    }
+    /**
+     * Answer an operation with the result members it produced.
+     */
+    response(action, result) {
+        const metadata = xmlElement("ResponseMetadata", xmlValue("RequestId", simQueryRequestId));
+        return this.xml(200, `${action}Response`, `${xmlElement(`${action}Result`, result)}${metadata}`);
+    }
+    /**
+     * Refuse a request by name, in the shape an SDK reads an error out of.
+     */
+    error(status, code, message) {
+        const fault = status >= 500 ? "Receiver" : "Sender";
+        const error = xmlElement("Error", xmlValue("Type", fault) +
+            xmlValue("Code", code) +
+            xmlValue("Message", message));
+        return this.xml(status, "ErrorResponse", `${error}${xmlValue("RequestId", simQueryRequestId)}`);
+    }
+    /**
+     * Report what a simulated operation threw.
+     *
+     * A simulated service error already carries the AWS exception name and the
+     * status real AWS answers with, so an SDK raises it under the name a handler
+     * catching it in production would see.
+     */
+    failure(error) {
+        const code = error instanceof Error ? error.name : "InternalFailure";
+        const message = error instanceof Error ? error.message : String(error);
+        return this.error(simSdkWireErrorStatusCode(error), code, message);
+    }
+    xml(status, rootName, content) {
+        const body = '<?xml version="1.0" encoding="UTF-8"?>' +
+            `<${rootName} xmlns="${escapeXmlText(this.namespace)}">${content}</${rootName}>`;
+        return new Response(body, {
+            status,
+            headers: { "content-type": "text/xml" },
+        });
+    }
+}
+//# sourceMappingURL=sim-query-response.js.map

package/dist/serve/http/api/query/sim-query-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-query-response.js","sourceRoot":"","sources":["../../../../../src/serve/http/api/query/sim-query-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAE1F;;GAEG;AACH,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,CAAS;IAEnC,YAAY,SAAiB;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,MAAc;QACrC,MAAM,QAAQ,GAAG,UAAU,CACzB,kBAAkB,EAClB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC,CACzC,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CACb,GAAG,EACH,GAAG,MAAM,UAAU,EACnB,GAAG,UAAU,CAAC,GAAG,MAAM,QAAQ,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,CACtD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAc,EAAE,IAAY,EAAE,OAAe;QACjD,MAAM,KAAK,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpD,MAAM,KAAK,GAAG,UAAU,CACtB,OAAO,EACP,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;YACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;YACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAC/B,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CACb,MAAM,EACN,eAAe,EACf,GAAG,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,CACtD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAc;QACpB,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACrE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAEO,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,OAAe;QAC3D,MAAM,IAAI,GACR,wCAAwC;YACxC,IAAI,QAAQ,WAAW,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,KAAK,QAAQ,GAAG,CAAC;QAEnF,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM;YACN,OAAO,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/serve/http/api/query/sim-query-result.d.ts

@@ -0,0 +1,33 @@
+/**
+ * One simulated operation's output, as the members a Query result writes.
+ */
+export type SimQueryOutput = Readonly<Record<string, unknown>>;
+/**
+ * Write the named members of a structure, in the order they are given.
+ *
+ * Query writes a member the operation did not produce as no element at all
+ * rather than as an empty one, which is what `xmlValue` does with an absent
+ * value.
+ */
+export declare function queryMembers(value: SimQueryOutput, names: readonly string[]): string;
+/**
+ * Write a structure member, whose own members Query nests inside it.
+ *
+ * A structure the operation did not produce writes nothing, the same way an
+ * absent scalar member does, so a caller reads its absence rather than an
+ * empty element.
+ */
+export declare function queryStructure(value: SimQueryOutput, name: string, members: (structure: SimQueryOutput) => string): string;
+/**
+ * Write a list member, whose items Query wraps one `member` element each.
+ */
+export declare function queryList(value: SimQueryOutput, name: string, item: (member: SimQueryOutput) => string): string;
+/**
+ * Write a list member whose items are values rather than structures.
+ */
+export declare function queryScalarList(value: SimQueryOutput, name: string): string;
+/**
+ * Write a map member, whose pairs Query wraps one `entry` element each.
+ */
+export declare function queryMap(value: SimQueryOutput, name: string): string;
+//# sourceMappingURL=sim-query-result.d.ts.map

package/dist/serve/http/api/query/sim-query-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-query-result.d.ts","sourceRoot":"","sources":["../../../../../src/serve/http/api/query/sim-query-result.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,MAAM,GAC7C,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,GACvC,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU3E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBpE"}

package/dist/serve/http/api/query/sim-query-result.js

@@ -0,0 +1,87 @@
+/* oxlint-disable security/detect-object-injection -- every lookup here reads
+   a member the operation's own result writer named, out of the output that
+   operation produced. */
+import { isRecord } from "../../../../util/type-guard/record.js";
+import { xmlElement, xmlValue } from "../../../../util/xml/xml-writer.js";
+/**
+ * Write the named members of a structure, in the order they are given.
+ *
+ * Query writes a member the operation did not produce as no element at all
+ * rather than as an empty one, which is what `xmlValue` does with an absent
+ * value.
+ */
+export function queryMembers(value, names) {
+    return names.map((name) => xmlValue(name, queryScalar(value[name]))).join("");
+}
+/**
+ * Write a structure member, whose own members Query nests inside it.
+ *
+ * A structure the operation did not produce writes nothing, the same way an
+ * absent scalar member does, so a caller reads its absence rather than an
+ * empty element.
+ */
+export function queryStructure(value, name, members) {
+    const structure = value[name];
+    return isRecord(structure) ? xmlElement(name, members(structure)) : "";
+}
+/**
+ * Write a list member, whose items Query wraps one `member` element each.
+ */
+export function queryList(value, name, item) {
+    const items = value[name];
+    if (!Array.isArray(items)) {
+        return "";
+    }
+    const members = items
+        .map((member) => xmlElement("member", item(asQueryOutput(member))))
+        .join("");
+    return xmlElement(name, members);
+}
+/**
+ * Write a list member whose items are values rather than structures.
+ */
+export function queryScalarList(value, name) {
+    const items = value[name];
+    if (!Array.isArray(items)) {
+        return "";
+    }
+    return xmlElement(name, items.map((item) => xmlValue("member", queryScalar(item))).join(""));
+}
+/**
+ * Write a map member, whose pairs Query wraps one `entry` element each.
+ */
+export function queryMap(value, name) {
+    const map = value[name];
+    if (!isRecord(map)) {
+        return "";
+    }
+    const entries = Object.entries(map)
+        .map(([key, entry]) => xmlElement("entry", xmlValue("key", key) + xmlValue("value", queryScalar(entry))))
+        .join("");
+    return xmlElement(name, entries);
+}
+/**
+ * Read an output member as the value XML text carries.
+ *
+ * A member the operation left out writes nothing, and so does a null. Both
+ * mean the response has nothing to say about it. Anything that is not already
+ * a scalar is a structure a Query member has no shape for, such as a
+ * CloudFormation Output whose value resolved to a list, and it travels as its
+ * JSON so the caller sees what it is rather than `[object Object]`.
+ */
+function queryScalar(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value instanceof Date) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function asQueryOutput(member) {
+    return isRecord(member) ? member : {};
+}
+//# sourceMappingURL=sim-query-result.js.map

package/dist/serve/http/api/query/sim-query-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-query-result.js","sourceRoot":"","sources":["../../../../../src/serve/http/api/query/sim-query-result.ts"],"names":[],"mappings":"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"}

package/dist/serve/http/api/rest-json/sim-rest-json-endpoint.d.ts

@@ -0,0 +1,40 @@
+import type { SimAwsCaller } from "../../../../service/aws/caller/sim-aws-caller.js";
+import type { SimAws } from "../../../../service/aws/sim-aws.js";
+import type { SimRestJsonRoute } from "./sim-rest-json-route.type.js";
+interface SimRestJsonApiEndpointProperties {
+    readonly simAws: SimAws;
+    /** The SDK service id the simulated service's Command router is under. */
+    readonly serviceId: string;
+    readonly routes: readonly SimRestJsonRoute[];
+}
+/**
+ * Serves one REST-JSON service to a client given an endpoint URL.
+ *
+ * REST-JSON names its operation in the method and the path rather than in a
+ * header, so the operation is resolved from the request before anything else.
+ * Both the routing and the JSON on either side of it are the protocol rather
+ * than the service, so every REST-JSON service is served by an instance of
+ * this, holding the routes it implements.
+ *
+ * An operation runs through the Command an SDK would have sent, so an HTTP
+ * caller reaches exactly the code an in-process caller does, and IAM
+ * authorizes it the same way.
+ */
+export declare class SimRestJsonApiEndpoint {
+    private readonly dispatcher;
+    private readonly serviceId;
+    private readonly routes;
+    private readonly protocol;
+    constructor(properties: SimRestJsonApiEndpointProperties);
+    /**
+     * Answer one REST-JSON request as the caller that signed it.
+     *
+     * A path no route serves is refused by name rather than answered by an
+     * operation that shares its method. Ignoring the difference would answer a
+     * question about one thing with a confident report about another, which is
+     * worse than saying so.
+     */
+    handle(request: Request, body: Uint8Array, caller: SimAwsCaller, regionName: string): Promise<Response>;
+}
+export {};
+//# sourceMappingURL=sim-rest-json-endpoint.d.ts.map

package/dist/serve/http/api/rest-json/sim-rest-json-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-json-endpoint.d.ts","sourceRoot":"","sources":["../../../../../src/serve/http/api/rest-json/sim-rest-json-endpoint.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAIjE,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAGvC,UAAU,gCAAgC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,YAAY,UAAU,EAAE,gCAAgC,EAIvD;IAED;;;;;;;OAOG;IACG,MAAM,CACV,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAwCnB;CACF"}

package/dist/serve/http/api/rest-json/sim-rest-json-endpoint.js

@@ -0,0 +1,67 @@
+import { SimSdkUnsupportedCommandError } from "../../../../sdk/error/sim-sdk.error.js";
+import { SimSdkCommandDispatcher } from "../../../../sdk/sim-sdk-command-dispatcher.js";
+import { makeSimSdkWireClient, makeSimSdkWireCommand, } from "../../../../sdk/wire/sim-sdk-wire-command.js";
+import { SimRestJsonInput } from "./sim-rest-json-input.js";
+import { readSimRestJsonRequest } from "./sim-rest-json-request.js";
+import { SimRestJsonProtocol } from "./sim-rest-json-response.js";
+import { resolveSimRestJsonRoute } from "./sim-rest-json-routes.js";
+/**
+ * Serves one REST-JSON service to a client given an endpoint URL.
+ *
+ * REST-JSON names its operation in the method and the path rather than in a
+ * header, so the operation is resolved from the request before anything else.
+ * Both the routing and the JSON on either side of it are the protocol rather
+ * than the service, so every REST-JSON service is served by an instance of
+ * this, holding the routes it implements.
+ *
+ * An operation runs through the Command an SDK would have sent, so an HTTP
+ * caller reaches exactly the code an in-process caller does, and IAM
+ * authorizes it the same way.
+ */
+export class SimRestJsonApiEndpoint {
+    dispatcher;
+    serviceId;
+    routes;
+    protocol = new SimRestJsonProtocol();
+    constructor(properties) {
+        this.dispatcher = new SimSdkCommandDispatcher(properties.simAws);
+        this.serviceId = properties.serviceId;
+        this.routes = properties.routes;
+    }
+    /**
+     * Answer one REST-JSON request as the caller that signed it.
+     *
+     * A path no route serves is refused by name rather than answered by an
+     * operation that shares its method. Ignoring the difference would answer a
+     * question about one thing with a confident report about another, which is
+     * worse than saying so.
+     */
+    async handle(request, body, caller, regionName) {
+        const restRequest = readSimRestJsonRequest(request, body);
+        const matched = resolveSimRestJsonRoute(this.routes, restRequest);
+        if (matched === undefined) {
+            return this.protocol.error(501, "NotImplemented", `Simulated ${this.serviceId} does not serve ` +
+                `${restRequest.method} ${restRequest.path}`);
+        }
+        const { route } = matched;
+        try {
+            const input = route.input(new SimRestJsonInput({
+                labels: matched.labels,
+                query: restRequest.query,
+                headers: restRequest.headers,
+                body: restRequest.body,
+            }));
+            const output = (await this.dispatcher.dispatch(makeSimSdkWireCommand(route.commandName, input), makeSimSdkWireClient(this.serviceId, regionName), undefined, caller));
+            return route.output === undefined
+                ? this.protocol.response(output ?? {}, route.status ?? 200)
+                : route.output(output ?? {});
+        }
+        catch (error) {
+            if (error instanceof SimSdkUnsupportedCommandError) {
+                return this.protocol.error(501, "NotImplemented", error.message);
+            }
+            return this.protocol.failure(error);
+        }
+    }
+}
+//# sourceMappingURL=sim-rest-json-endpoint.js.map

package/dist/serve/http/api/rest-json/sim-rest-json-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-json-endpoint.js","sourceRoot":"","sources":["../../../../../src/serve/http/api/rest-json/sim-rest-json-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,8CAA8C,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAKlE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAWpE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IAChB,UAAU,CAA0B;IACpC,SAAS,CAAS;IAClB,MAAM,CAA8B;IACpC,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAEtD,YAAY,UAA4C;QACtD,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,OAAgB,EAChB,IAAgB,EAChB,MAAoB,EACpB,UAAkB;QAElB,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CACxB,GAAG,EACH,gBAAgB,EAChB,aAAa,IAAI,CAAC,SAAS,kBAAkB;gBAC3C,GAAG,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,CAC9C,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CACvB,IAAI,gBAAgB,CAAC;gBACnB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAC5C,qBAAqB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,EAC/C,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAChD,SAAS,EACT,MAAM,CACP,CAAkC,CAAC;YAEpC,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC/B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;gBAC3D,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;gBACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/serve/http/api/rest-json/sim-rest-json-input.d.ts

@@ -0,0 +1,45 @@
+interface SimRestJsonInputProperties {
+    readonly labels: ReadonlyMap<string, string>;
+    readonly query: URLSearchParams;
+    readonly headers: Headers;
+    readonly body: Uint8Array;
+}
+/**
+ * The four places a REST-JSON request states its input, behind one accessor.
+ *
+ * REST-JSON spreads one operation's members across a path, a query string,
+ * headers and a JSON body, and which member goes where is the operation's own
+ * business. An operation's route reads the members it has from wherever it put
+ * them, and this is what it reads them with.
+ */
+export declare class SimRestJsonInput {
+    readonly body: Uint8Array;
+    private readonly labels;
+    private readonly parameters;
+    private readonly headers;
+    constructor(properties: SimRestJsonInputProperties);
+    /**
+     * A member the path stated, named by the route template that matched it.
+     */
+    label(name: string): string | undefined;
+    /**
+     * A member the query string stated.
+     */
+    query(name: string): string | undefined;
+    /**
+     * A member a header stated, matched however the client cased the name.
+     */
+    header(name: string): string | undefined;
+    /**
+     * The members the JSON body stated, which are the input shape as it is.
+     *
+     * The wire shape of a REST-JSON body is the Command input shape member for
+     * member, apart from the members JSON cannot carry: a blob travels base64
+     * encoded and a timestamp as epoch seconds. A route reading one of those
+     * decodes it itself, since only the operation's own schema says which
+     * members they are.
+     */
+    json(): Readonly<Record<string, unknown>>;
+}
+export {};
+//# sourceMappingURL=sim-rest-json-input.d.ts.map

package/dist/serve/http/api/rest-json/sim-rest-json-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-json-input.d.ts","sourceRoot":"","sources":["../../../../../src/serve/http/api/rest-json/sim-rest-json-input.ts"],"names":[],"mappings":"AAEA,UAAU,0BAA0B;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,YAAY,UAAU,EAAE,0BAA0B,EAKjD;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAExC;CACF"}

package/dist/serve/http/api/rest-json/sim-rest-json-input.js

@@ -0,0 +1,52 @@
+import { readSimRestJsonBody } from "./sim-rest-json-request.js";
+/**
+ * The four places a REST-JSON request states its input, behind one accessor.
+ *
+ * REST-JSON spreads one operation's members across a path, a query string,
+ * headers and a JSON body, and which member goes where is the operation's own
+ * business. An operation's route reads the members it has from wherever it put
+ * them, and this is what it reads them with.
+ */
+export class SimRestJsonInput {
+    body;
+    labels;
+    parameters;
+    headers;
+    constructor(properties) {
+        this.labels = properties.labels;
+        this.parameters = properties.query;
+        this.headers = properties.headers;
+        this.body = properties.body;
+    }
+    /**
+     * A member the path stated, named by the route template that matched it.
+     */
+    label(name) {
+        return this.labels.get(name);
+    }
+    /**
+     * A member the query string stated.
+     */
+    query(name) {
+        return this.parameters.get(name) ?? undefined;
+    }
+    /**
+     * A member a header stated, matched however the client cased the name.
+     */
+    header(name) {
+        return this.headers.get(name) ?? undefined;
+    }
+    /**
+     * The members the JSON body stated, which are the input shape as it is.
+     *
+     * The wire shape of a REST-JSON body is the Command input shape member for
+     * member, apart from the members JSON cannot carry: a blob travels base64
+     * encoded and a timestamp as epoch seconds. A route reading one of those
+     * decodes it itself, since only the operation's own schema says which
+     * members they are.
+     */
+    json() {
+        return readSimRestJsonBody(this.body);
+    }
+}
+//# sourceMappingURL=sim-rest-json-input.js.map

package/dist/serve/http/api/rest-json/sim-rest-json-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-json-input.js","sourceRoot":"","sources":["../../../../../src/serve/http/api/rest-json/sim-rest-json-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AASjE;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,CAAa;IAET,MAAM,CAA8B;IACpC,UAAU,CAAkB;IAC5B,OAAO,CAAU;IAElC,YAAY,UAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IAC7C,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI;QACF,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}