@volter/twin-upstash 0.1.0

package/dist/qstash/src/doors.js

@@ -0,0 +1,33 @@
+import { DELIVERY, DESTINATION } from "./semantics/delivery.js";
+/** A statement without an http(s) URL and a numeric status: refused, the World unchanged. */
+function malformedStatement() {
+    return Response.json({ error: 'a url (http or https) and a status (a number) are required' }, { status: 400 });
+}
+/** The operation a door's context is named by: no spec operation is. */
+export const DOOR = { id: 'TwinDoor', method: 'POST', path: '/_twin', class: 'action' };
+/** A door's answer, or undefined for a request that is not a door's. `report` is what the catch-up in front did. */
+export async function door(ctx, request, report) {
+    const url = new URL(request.url);
+    const path = url.pathname.replace(/\/+$/, '');
+    if (request.method === 'POST' && path === '/v2/_twin/drain')
+        return Response.json(report);
+    if (request.method === 'GET' && path === '/_twin/deliveries') {
+        const to = url.searchParams.get('to') ?? '';
+        if (!to)
+            return Response.json({ error: 'to is required' }, { status: 400 });
+        const deliveries = ctx.rowsRaw(DELIVERY).filter((d) => d.to === to)
+            .sort((a, b) => String(a.at).localeCompare(String(b.at)) || Number(a.n) - Number(b.n))
+            .map((d) => ({ messageId: d.message_id, retried: d.retried, at: d.at, method: d.method, headers: d.headers, body: d.body, status: d.status }));
+        return Response.json({ to, deliveries });
+    }
+    if (request.method === 'POST' && path === '/_twin/destinations') {
+        const b = (ctx.body && typeof ctx.body === 'object' ? ctx.body : {});
+        if (typeof b.url !== 'string' || !/^https?:\/\//.test(b.url) || typeof b.status !== 'number')
+            return malformedStatement();
+        const when = b.when && typeof b.when === 'object' ? b.when : {};
+        const id = `${b.url} ${Object.entries(when).map(([k, v]) => `${k.toLowerCase()}=${v}`).sort().join('&')}`.trim();
+        await ctx.record(DESTINATION, { url: b.url, status: b.status, body: typeof b.body === 'string' ? b.body : '', headers: b.headers ?? {}, when }, id);
+        return new Response(null, { status: 204 });
+    }
+    return undefined;
+}

package/dist/qstash/src/doors.ts

@@ -0,0 +1,51 @@
+// The World's doors in front of the QStash lane (docs/contributing/architecture.md, "Doors, screens and the gap"). QStash
+// delivers to the customer's own HTTP endpoints, which are outside Upstash: what an endpoint received and how it answers
+// are the World's, read and stated here, as Slack's app deliveries are read (packages/twin/slack/src/slack-interactions.ts,
+// `GET /_twin/deliveries?to=`) and as an outside mail server's answer is stated (packages/twin/resend/src/resend-doors.ts,
+// `POST /_twin/recipients/:domain`).
+//
+// - GET /_twin/deliveries?to=<url> → {to, deliveries}: every request QStash made to that URL, oldest first, each as the
+//   endpoint received it (its method, headers and body) and the status it answered.
+// - POST /_twin/destinations {url, status, body?, headers?, when?} → 204: the World's word on how the endpoints under a URL
+//   answer, and, with `when` (header names and values), how they answer a delivery carrying those headers (a workflow's
+//   route answers its failure call, `Upstash-Workflow-Is-Failure: true`, apart from its steps). The statement that names
+//   headers the delivery carries decides before one that names none, then the longest prefix. A fact about the World, like a person's password: QStash's own
+//   delivery attempt reads it (semantics/delivery.ts), and retries an endpoint that answers an error. A destination the
+//   World states nothing for is asked over HTTP where the World lets the request out.
+// - POST /v2/_twin/drain → the catch-up's report: the World's runner (a served World's drainer) asks the lane to run
+//   what the World clock has made due now. Every request the lane answers runs the same catch-up first; this one asks for
+//   nothing else. It is not QStash's API and answers only here.
+import type { DerivedOperation, SemanticsContext } from '@volter/world-core';
+import { DELIVERY, DESTINATION, type CatchUpReport } from './semantics/delivery.ts';
+
+/** A statement without an http(s) URL and a numeric status: refused, the World unchanged. */
+function malformedStatement(): Response {
+  return Response.json({ error: 'a url (http or https) and a status (a number) are required' }, { status: 400 });
+}
+
+/** The operation a door's context is named by: no spec operation is. */
+export const DOOR: DerivedOperation = { id: 'TwinDoor', method: 'POST', path: '/_twin', class: 'action' };
+
+/** A door's answer, or undefined for a request that is not a door's. `report` is what the catch-up in front did. */
+export async function door(ctx: SemanticsContext, request: Request, report: CatchUpReport): Promise<Response | undefined> {
+  const url = new URL(request.url);
+  const path = url.pathname.replace(/\/+$/, '');
+  if (request.method === 'POST' && path === '/v2/_twin/drain') return Response.json(report);
+  if (request.method === 'GET' && path === '/_twin/deliveries') {
+    const to = url.searchParams.get('to') ?? '';
+    if (!to) return Response.json({ error: 'to is required' }, { status: 400 });
+    const deliveries = ctx.rowsRaw(DELIVERY).filter((d) => d.to === to)
+      .sort((a, b) => String(a.at).localeCompare(String(b.at)) || Number(a.n) - Number(b.n))
+      .map((d) => ({ messageId: d.message_id, retried: d.retried, at: d.at, method: d.method, headers: d.headers, body: d.body, status: d.status }));
+    return Response.json({ to, deliveries });
+  }
+  if (request.method === 'POST' && path === '/_twin/destinations') {
+    const b = (ctx.body && typeof ctx.body === 'object' ? ctx.body : {}) as Record<string, unknown>;
+    if (typeof b.url !== 'string' || !/^https?:\/\//.test(b.url) || typeof b.status !== 'number') return malformedStatement();
+    const when = b.when && typeof b.when === 'object' ? (b.when as Record<string, string>) : {};
+    const id = `${b.url} ${Object.entries(when).map(([k, v]) => `${k.toLowerCase()}=${v}`).sort().join('&')}`.trim();
+    await ctx.record(DESTINATION, { url: b.url, status: b.status, body: typeof b.body === 'string' ? b.body : '', headers: b.headers ?? {}, when }, id);
+    return new Response(null, { status: 204 });
+  }
+  return undefined;
+}

package/dist/qstash/src/egress.d.ts

@@ -0,0 +1,7 @@
+export type Outcome = {
+    status: number;
+    body: string;
+    headers: Record<string, string>;
+    error?: string;
+};
+export declare function post(url: string, method: string, headers: Record<string, string>, body: string): Promise<Outcome>;

package/dist/qstash/src/egress.js

@@ -0,0 +1,66 @@
+// The QStash lane's one outbound request: a delivery to the publisher's own destination (usually the application inside
+// the World). The catch-up (semantics/delivery.ts) decides what is delivered and when; this performs one request and
+// reports the destination's answer. The colocated twin host runs without the World's injector, so the kernel applies
+// the World's rules before any socket opens: a destination on one of the application's own hostnames (its production
+// URL, which an app in production mode publishes to) reaches the application where it listens (`appDestination`);
+// otherwise `worldEgressRefusal` decides (internal addresses pass; a sealed World refuses the rest), and a refusal is a
+// failed attempt, as an unreachable host is: QStash reports no answer as status -1.
+import { appDestination, deliverToApp } from '@volter/world-core/app-route';
+import { worldEgressRefusal } from '@volter/world-core/network-policy';
+export async function post(url, method, headers, body) {
+    if (appDestination(url))
+        return toApp(url, method, headers, body);
+    const refusal = worldEgressRefusal(url);
+    return refusal !== null ? { status: -1, body: '', headers: {}, error: refusal } : send(url, method, headers, body);
+}
+/** The request itself, to a destination the World lets the request out to. */
+async function send(url, method, headers, body) {
+    try {
+        const res = await fetch(url, { method, headers, ...(method !== 'GET' && method !== 'HEAD' ? { body } : {}) });
+        const out = {};
+        res.headers.forEach((v, k) => { out[k.toLowerCase()] = v; });
+        return { status: res.status, body: await res.text(), headers: out };
+    }
+    catch (error) {
+        return { status: -1, body: '', headers: {}, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** A delivery to the application, answered as the lane's other deliveries are (fetch's defaults: a redirect followed,
+ *  at most 20, a 303, or a 301/302 after a POST, becoming a GET without its body), each hop routed again. */
+async function toApp(url, method, headers, body) {
+    let at = url;
+    let m = method;
+    let b = body;
+    const h = { ...headers };
+    for (let hops = 0;; hops++) {
+        const app = appDestination(at);
+        // leaving the application drops what fetch drops crossing origins
+        if (!app) {
+            for (const k of Object.keys(h))
+                if (['authorization', 'cookie', 'proxy-authorization'].includes(k.toLowerCase()))
+                    delete h[k];
+            return post(at, m, h, b ?? '');
+        }
+        let answer;
+        try {
+            answer = await deliverToApp(app, at, { method: m, headers: h, body: b });
+        }
+        catch (error) {
+            return { status: -1, body: '', headers: {}, error: error instanceof Error ? error.message : String(error) };
+        }
+        const location = answer.headers.location;
+        if (![301, 302, 303, 307, 308].includes(answer.status) || !location)
+            return answer;
+        if (hops >= 20)
+            return { status: -1, body: '', headers: {}, error: 'redirect count exceeded' };
+        at = new URL(location, at).toString();
+        if (answer.status === 303 || ((answer.status === 301 || answer.status === 302) && m === 'POST')) {
+            if (m !== 'HEAD')
+                m = 'GET';
+            b = undefined;
+            for (const k of Object.keys(h))
+                if (/^content-/i.test(k))
+                    delete h[k];
+        }
+    }
+}

package/dist/qstash/src/egress.ts

@@ -0,0 +1,58 @@
+// The QStash lane's one outbound request: a delivery to the publisher's own destination (usually the application inside
+// the World). The catch-up (semantics/delivery.ts) decides what is delivered and when; this performs one request and
+// reports the destination's answer. The colocated twin host runs without the World's injector, so the kernel applies
+// the World's rules before any socket opens: a destination on one of the application's own hostnames (its production
+// URL, which an app in production mode publishes to) reaches the application where it listens (`appDestination`);
+// otherwise `worldEgressRefusal` decides (internal addresses pass; a sealed World refuses the rest), and a refusal is a
+// failed attempt, as an unreachable host is: QStash reports no answer as status -1.
+import { appDestination, deliverToApp } from '@volter/world-core/app-route';
+import { worldEgressRefusal } from '@volter/world-core/network-policy';
+
+export type Outcome = { status: number; body: string; headers: Record<string, string>; error?: string };
+
+export async function post(url: string, method: string, headers: Record<string, string>, body: string): Promise<Outcome> {
+  if (appDestination(url)) return toApp(url, method, headers, body);
+  const refusal = worldEgressRefusal(url);
+  return refusal !== null ? { status: -1, body: '', headers: {}, error: refusal } : send(url, method, headers, body);
+}
+
+/** The request itself, to a destination the World lets the request out to. */
+async function send(url: string, method: string, headers: Record<string, string>, body: string): Promise<Outcome> {
+  try {
+    const res = await fetch(url, { method, headers, ...(method !== 'GET' && method !== 'HEAD' ? { body } : {}) });
+    const out: Record<string, string> = {};
+    res.headers.forEach((v, k) => { out[k.toLowerCase()] = v; });
+    return { status: res.status, body: await res.text(), headers: out };
+  } catch (error) {
+    return { status: -1, body: '', headers: {}, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+/** A delivery to the application, answered as the lane's other deliveries are (fetch's defaults: a redirect followed,
+ *  at most 20, a 303, or a 301/302 after a POST, becoming a GET without its body), each hop routed again. */
+async function toApp(url: string, method: string, headers: Record<string, string>, body: string): Promise<Outcome> {
+  let at = url; let m = method; let b: string | undefined = body; const h = { ...headers };
+  for (let hops = 0; ; hops++) {
+    const app = appDestination(at);
+    // leaving the application drops what fetch drops crossing origins
+    if (!app) {
+      for (const k of Object.keys(h)) if (['authorization', 'cookie', 'proxy-authorization'].includes(k.toLowerCase())) delete h[k];
+      return post(at, m, h, b ?? '');
+    }
+    let answer;
+    try {
+      answer = await deliverToApp(app, at, { method: m, headers: h, body: b });
+    } catch (error) {
+      return { status: -1, body: '', headers: {}, error: error instanceof Error ? error.message : String(error) };
+    }
+    const location = answer.headers.location;
+    if (![301, 302, 303, 307, 308].includes(answer.status) || !location) return answer;
+    if (hops >= 20) return { status: -1, body: '', headers: {}, error: 'redirect count exceeded' };
+    at = new URL(location, at).toString();
+    if (answer.status === 303 || ((answer.status === 301 || answer.status === 302) && m === 'POST')) {
+      if (m !== 'HEAD') m = 'GET';
+      b = undefined;
+      for (const k of Object.keys(h)) if (/^content-/i.test(k)) delete h[k];
+    }
+  }
+}

package/dist/qstash/src/fetch.d.ts

@@ -0,0 +1,7 @@
+import { type DerivedFetch } from '@volter/world-core';
+export type QstashLaneOptions = {
+    root?: string;
+    readOnly?: boolean;
+    clock?: () => string;
+};
+export declare function createQstashLaneFetch(options?: QstashLaneOptions): DerivedFetch;

package/dist/qstash/src/fetch.js

@@ -0,0 +1,48 @@
+// The QStash lane's fetch: QStash's and Workflow's API through the derived dispatch over the two documents' union, with the
+// World's doors and the lane's gate in front, and the catch-up before all of them. The upstash pack's fetch
+// (../../src/upstash-server.ts) sends it every request for a QStash host, every `/v2/` path (an application reaches QStash
+// at its QSTASH_URL, the pack's own address) and the lane's doors.
+import { bindSemantics, coreFor, createDerivedFetch, crossCutting, semanticsContext } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest, spanning } from "./manifest.js";
+import { door, DOOR } from "./doors.js";
+import { gate } from "./semantics/account.js";
+import { catchUp } from "./semantics/delivery.js";
+import { qstashSemantics } from "./semantics/index.js";
+// A catch-up delivers to the application, which may call QStash back while it answers (a workflow's route sends its next
+// step): that request is answered without a catch-up of its own, and the one already running takes up what it publishes.
+const catchingUp = new Set();
+export function createQstashLaneFetch(options = {}) {
+    const scope = { ...(options.root !== undefined ? { root: options.root } : {}), ...(options.clock ? { clock: options.clock } : {}) };
+    const derived = createDerivedFetch({
+        surface: { ...surface, spanning },
+        handlers: bindSemantics(manifest, qstashSemantics, scope),
+        core: coreFor(manifest, scope),
+        around: crossCutting(manifest, { readOnly: options.readOnly ?? false, ...scope }),
+        // an operation the lane does not serve, and a path neither document has. Where the documents stop and the lane
+        // decides: QStash's answer to an unknown request is not documented; the lane answers 404 in the Error schema.
+        gap: () => Response.json({ error: 'Not Found' }, { status: 404 }),
+    });
+    return Object.assign(async (request) => {
+        // a body labelled JSON that does not parse is QStash's 400 (the derived dispatch answers it, `malformedBody`); the
+        // catch-up and the doors in front read no body of it
+        const ctx = await semanticsContext(manifest, request.clone(), DOOR, scope)
+            .catch(() => semanticsContext(manifest, new Request(request.url, { method: request.method, headers: request.headers }), DOOR, scope));
+        const key = options.root ?? '';
+        let report = { delivered: [], retried: [], failed: [] };
+        if (!options.readOnly && !catchingUp.has(key)) {
+            catchingUp.add(key);
+            try {
+                report = await catchUp(ctx);
+            }
+            finally {
+                catchingUp.delete(key);
+            }
+        }
+        const own = await door(ctx, request, report);
+        if (own)
+            return own;
+        const admitted = gate(ctx, request);
+        return 'refused' in admitted ? admitted.refused : derived(request);
+    }, { owners: () => derived.owners() });
+}

package/dist/qstash/src/fetch.ts

@@ -0,0 +1,46 @@
+// The QStash lane's fetch: QStash's and Workflow's API through the derived dispatch over the two documents' union, with the
+// World's doors and the lane's gate in front, and the catch-up before all of them. The upstash pack's fetch
+// (../../src/upstash-server.ts) sends it every request for a QStash host, every `/v2/` path (an application reaches QStash
+// at its QSTASH_URL, the pack's own address) and the lane's doors.
+import { bindSemantics, coreFor, createDerivedFetch, crossCutting, semanticsContext, type DerivedFetch, type DerivedSurface } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest, spanning } from './manifest.ts';
+import { door, DOOR } from './doors.ts';
+import { gate } from './semantics/account.ts';
+import { catchUp, type CatchUpReport } from './semantics/delivery.ts';
+import { qstashSemantics } from './semantics/index.ts';
+
+export type QstashLaneOptions = { root?: string; readOnly?: boolean; clock?: () => string };
+
+// A catch-up delivers to the application, which may call QStash back while it answers (a workflow's route sends its next
+// step): that request is answered without a catch-up of its own, and the one already running takes up what it publishes.
+const catchingUp = new Set<string>();
+
+export function createQstashLaneFetch(options: QstashLaneOptions = {}): DerivedFetch {
+  const scope = { ...(options.root !== undefined ? { root: options.root } : {}), ...(options.clock ? { clock: options.clock } : {}) };
+  const derived = createDerivedFetch({
+    surface: { ...(surface as unknown as DerivedSurface), spanning },
+    handlers: bindSemantics(manifest, qstashSemantics, scope),
+    core: coreFor(manifest, scope),
+    around: crossCutting(manifest, { readOnly: options.readOnly ?? false, ...scope }),
+    // an operation the lane does not serve, and a path neither document has. Where the documents stop and the lane
+    // decides: QStash's answer to an unknown request is not documented; the lane answers 404 in the Error schema.
+    gap: () => Response.json({ error: 'Not Found' }, { status: 404 }),
+  });
+  return Object.assign(async (request: Request): Promise<Response> => {
+    // a body labelled JSON that does not parse is QStash's 400 (the derived dispatch answers it, `malformedBody`); the
+    // catch-up and the doors in front read no body of it
+    const ctx = await semanticsContext(manifest, request.clone(), DOOR, scope)
+      .catch(() => semanticsContext(manifest, new Request(request.url, { method: request.method, headers: request.headers }), DOOR, scope));
+    const key = options.root ?? '';
+    let report: CatchUpReport = { delivered: [], retried: [], failed: [] };
+    if (!options.readOnly && !catchingUp.has(key)) {
+      catchingUp.add(key);
+      try { report = await catchUp(ctx); } finally { catchingUp.delete(key); }
+    }
+    const own = await door(ctx, request, report);
+    if (own) return own;
+    const admitted = gate(ctx, request);
+    return 'refused' in admitted ? admitted.refused : derived(request);
+  }, { owners: () => derived.owners() });
+}

package/dist/qstash/src/generated/surface.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","spec":"openapi","format":"openapi","version":"2.0.0","resources":[{"name":"BulkAction","schema":"BulkAction","fields":[{"name":"actionId","type":"string","nullable":false},{"name":"completedAt","type":"integer","nullable":false},{"name":"createdAt","type":"integer","nullable":false},{"name":"filter","type":"object","nullable":false},{"name":"kind","type":"string","nullable":false,"enum":["cancel"]},{"name":"processed","type":"integer","nullable":false},{"name":"state","type":"string","nullable":false,"enum":["IN_PROGRESS","FINISHED"]},{"name":"total","type":"integer","nullable":false}],"stateCandidates":[{"field":"state","values":["FINISHED","IN_PROGRESS"]}],"expandable":[]},{"name":"Endpoint","schema":"Endpoint","fields":[{"name":"name","type":"string","nullable":false},{"name":"url","type":"string","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"FlowControlKey","schema":"FlowControlKey","fields":[{"name":"flowControlKey","type":"string","nullable":false},{"name":"isPaused","type":"boolean","nullable":false},{"name":"isPinnedParallelism","type":"boolean","nullable":false},{"name":"isPinnedRate","type":"boolean","nullable":false},{"name":"parallelismCount","type":"integer","nullable":false},{"name":"parallelismMax","type":"integer","nullable":false},{"name":"rateCount","type":"integer","nullable":false},{"name":"rateMax","type":"integer","nullable":false},{"name":"ratePeriod","type":"integer","nullable":false},{"name":"ratePeriodStart","type":"integer","nullable":false},{"name":"waitListSize","type":"integer","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"LogEntry","schema":"LogEntry","fields":[{"name":"body","type":"string","nullable":false},{"name":"callback","type":"string","nullable":false},{"name":"callbackHeaders","type":"object","nullable":false},{"name":"endpointName","type":"string","nullable":false},{"name":"error","type":"string","nullable":false},{"name":"failureCallback","type":"string","nullable":false},{"name":"failureCallbackHeaders","type":"object","nullable":false},{"name":"header","type":"object","nullable":false},{"name":"label","type":"string","nullable":false},{"name":"labels","type":"array","nullable":false},{"name":"maxRetries","type":"integer","nullable":false},{"name":"messageId","type":"string","nullable":false},{"name":"method","type":"string","nullable":false},{"name":"nextDeliveryTime","type":"integer","nullable":false},{"name":"queueName","type":"string","nullable":false},{"name":"responseBody","type":"string","nullable":false},{"name":"responseHeaders","type":"object","nullable":false},{"name":"responseStatus","type":"integer","nullable":false},{"name":"retryDelayExpression","type":"string","nullable":false},{"name":"scheduleId","type":"string","nullable":false},{"name":"state","type":"string","nullable":false,"enum":["CREATED","ACTIVE","RETRY","ERROR","DELIVERED","FAILED","CANCEL_REQUESTED","CANCELLED"]},{"name":"time","type":"integer","nullable":false},{"name":"timeout","type":"integer","nullable":false},{"name":"topicName","type":"string","nullable":false},{"name":"url","type":"string","nullable":false}],"stateCandidates":[{"field":"state","values":["ACTIVE","CANCELLED","CANCEL_REQUESTED","CREATED","DELIVERED","ERROR","FAILED","RETRY"]}],"expandable":[]},{"name":"Queue","schema":"Queue","fields":[{"name":"createdAt","type":"integer","nullable":false},{"name":"lag","type":"integer","nullable":false},{"name":"name","type":"string","nullable":false},{"name":"parallelism","type":"integer","nullable":false},{"name":"paused","type":"boolean","nullable":false},{"name":"updatedAt","type":"integer","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"Schedule","schema":"Schedule","fields":[{"name":"body","type":"string","nullable":false},{"name":"callback","type":"string","nullable":false},{"name":"callerIp","type":"string","nullable":false},{"name":"createdAt","type":"integer","nullable":false,"required":true},{"name":"cron","type":"string","nullable":false,"required":true},{"name":"delay","type":"integer","nullable":false},{"name":"destination","type":"string","nullable":false,"required":true},{"name":"failureCallback","type":"string","nullable":false},{"name":"flowControlKey","type":"string","nullable":false},{"name":"header","type":"object","nullable":false},{"name":"isPaused","type":"boolean","nullable":false,"required":true},{"name":"label","type":"string","nullable":false},{"name":"labels","type":"array","nullable":false},{"name":"lastScheduleStates","type":"object","nullable":false},{"name":"lastScheduleTime","type":"integer","nullable":false},{"name":"method","type":"string","nullable":false,"required":true},{"name":"nextScheduleTime","type":"integer","nullable":false},{"name":"parallelism","type":"integer","nullable":false},{"name":"period","type":"integer","nullable":false},{"name":"rate","type":"integer","nullable":false},{"name":"retries","type":"integer","nullable":false},{"name":"retryDelayExpression","type":"string","nullable":false},{"name":"scheduleId","type":"string","nullable":false,"required":true}],"stateCandidates":[],"expandable":[]},{"name":"URLGroup","schema":"URLGroup","fields":[{"name":"createdAt","type":"integer","nullable":false},{"name":"endpoints","type":"array","nullable":false},{"name":"name","type":"string","nullable":false},{"name":"updatedAt","type":"integer","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"Waiter","schema":"Waiter","fields":[{"name":"deadline","type":"integer","nullable":false},{"name":"headers","type":"object","nullable":false},{"name":"timeoutBody","type":"string","nullable":false},{"name":"timeoutHeaders","type":"object","nullable":false},{"name":"timeoutUrl","type":"string","nullable":false},{"name":"url","type":"string","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"WorkflowDLQMessage","schema":"WorkflowDLQMessage","fields":[{"name":"body","type":"string","nullable":false},{"name":"bodyBase64","type":"string","nullable":false},{"name":"callerIP","type":"string","nullable":false},{"name":"createdAt","type":"integer","nullable":false},{"name":"dlqId","type":"string","nullable":false},{"name":"failureCallback","type":"string","nullable":false},{"name":"failureFunctionState","type":"string","nullable":false},{"name":"flowControlKey","type":"string","nullable":false},{"name":"header","type":"object","nullable":false},{"name":"label","type":"string","nullable":false},{"name":"labels","type":"array","nullable":false},{"name":"maxRetries","type":"integer","nullable":false},{"name":"method","type":"string","nullable":false},{"name":"responseBody","type":"string","nullable":false},{"name":"responseBodyBase64","type":"string","nullable":false},{"name":"responseHeader","type":"object","nullable":false},{"name":"responseStatus","type":"integer","nullable":false},{"name":"url","type":"string","nullable":false},{"name":"workflowCreatedAt","type":"integer","nullable":false},{"name":"workflowRunId","type":"string","nullable":false},{"name":"workflowUrl","type":"string","nullable":false}],"stateCandidates":[],"expandable":[]},{"name":"WorkflowRun","schema":"WorkflowRun","fields":[{"name":"dlqId","type":"string","nullable":false},{"name":"failureFunction","type":"FailureFunction","nullable":false},{"name":"flowControlKey","type":"string","nullable":false},{"name":"invoker","type":"InvokerContext","nullable":false},{"name":"label","type":"string","nullable":false},{"name":"labels","type":"array","nullable":false},{"name":"steps","type":"array","nullable":false},{"name":"workflowRunCallerIp","type":"string","nullable":false},{"name":"workflowRunCompletedAt","type":"integer","nullable":false},{"name":"workflowRunCreatedAt","type":"integer","nullable":false},{"name":"workflowRunId","type":"string","nullable":false},{"name":"workflowRunResponse","type":"string","nullable":false},{"name":"workflowState","type":"string","nullable":false},{"name":"workflowUrl","type":"string","nullable":false}],"stateCandidates":[],"expandable":[]}],"operations":[{"id":"post_v2_batch","method":"post","path":"/v2/batch","pathParams":[],"query":[],"body":[],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"post_v2_batch_trigger","method":"post","path":"/v2/batch/trigger","pathParams":[],"query":[],"body":[],"bodyEncoding":"json","successStatus":201,"class":"non-resource"},{"id":"get_v2_bulkactions","method":"get","path":"/v2/bulkActions","pathParams":[],"query":[{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"state","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"BulkAction","list":true,"key":"bulkActions"},"class":"list","resource":"BulkAction"},{"id":"get_v2_bulkactions_actionid","method":"get","path":"/v2/bulkActions/{actionId}","pathParams":["actionId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"BulkAction","list":false},"class":"retrieve","resource":"BulkAction"},{"id":"get_v2_dlq","method":"get","path":"/v2/dlq","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"messageId","type":"string","required":false},{"name":"queueName","type":"array","required":false},{"name":"responseStatus","type":"array","required":false},{"name":"scheduleId","type":"array","required":false},{"name":"source","type":"string","required":false},{"name":"toDate","type":"integer","required":false},{"name":"topicName","type":"array","required":false},{"name":"url","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"delete_v2_dlq","method":"delete","path":"/v2/dlq","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"dlqIds","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"messageId","type":"string","required":false},{"name":"queueName","type":"array","required":false},{"name":"responseStatus","type":"array","required":false},{"name":"scheduleId","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"topicName","type":"array","required":false},{"name":"url","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action"},{"id":"get_v2_dlq_dlqid","method":"get","path":"/v2/dlq/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"delete_v2_dlq_dlqid","method":"delete","path":"/v2/dlq/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete"},{"id":"post_v2_dlq_retry","method":"post","path":"/v2/dlq/retry","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"dlqIds","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"messageId","type":"string","required":false},{"name":"queueName","type":"array","required":false},{"name":"responseStatus","type":"array","required":false},{"name":"scheduleId","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"topicName","type":"array","required":false},{"name":"url","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":201,"class":"non-resource"},{"id":"post_v2_dlq_retry_dlqid","method":"post","path":"/v2/dlq/retry/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":201,"class":"non-resource"},{"id":"post_v2_enqueue_queuename_destination","method":"post","path":"/v2/enqueue/{queueName}/{destination}","pathParams":["queueName","destination","queueName"],"query":[],"body":[],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"get_v2_flowcontrol","method":"get","path":"/v2/flowControl","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"FlowControlKey","list":true},"class":"list","resource":"FlowControlKey"},{"id":"get_v2_flowcontrol_flowcontrolkey","method":"get","path":"/v2/flowControl/{flowControlKey}","pathParams":["flowControlKey"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"FlowControlKey","list":false},"class":"retrieve","resource":"FlowControlKey"},{"id":"post_v2_flowcontrol_flowcontrolkey_pause","method":"post","path":"/v2/flowControl/{flowControlKey}/pause","pathParams":["flowControlKey"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"FlowControlKey"},{"id":"post_v2_flowcontrol_flowcontrolkey_pin","method":"post","path":"/v2/flowControl/{flowControlKey}/pin","pathParams":["flowControlKey"],"query":[{"name":"parallelism","type":"integer","required":false},{"name":"period","type":"integer","required":false},{"name":"rate","type":"integer","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"FlowControlKey"},{"id":"post_v2_flowcontrol_flowcontrolkey_resetrate","method":"post","path":"/v2/flowControl/{flowControlKey}/resetRate","pathParams":["flowControlKey"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"FlowControlKey"},{"id":"post_v2_flowcontrol_flowcontrolkey_resume","method":"post","path":"/v2/flowControl/{flowControlKey}/resume","pathParams":["flowControlKey"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"FlowControlKey"},{"id":"post_v2_flowcontrol_flowcontrolkey_unpin","method":"post","path":"/v2/flowControl/{flowControlKey}/unpin","pathParams":["flowControlKey"],"query":[{"name":"parallelism","type":"boolean","required":false},{"name":"rate","type":"boolean","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"FlowControlKey"},{"id":"get_v2_globalparallelism","method":"get","path":"/v2/globalParallelism","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"get_v2_keys","method":"get","path":"/v2/keys","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"get_v2_keys_rotate","method":"get","path":"/v2/keys/rotate","pathParams":["flowControlKey"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"FlowControlKey","list":false},"class":"retrieve","resource":"FlowControlKey"},{"id":"post_v2_keys_rotate","method":"post","path":"/v2/keys/rotate","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"get_v2_logs","method":"get","path":"/v2/logs","pathParams":[],"query":[{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"messageId","type":"string","required":false},{"name":"queueName","type":"string","required":false},{"name":"scheduleId","type":"string","required":false},{"name":"state","type":"string","required":false},{"name":"toDate","type":"integer","required":false},{"name":"topicName","type":"string","required":false},{"name":"url","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"LogEntry","list":true,"key":"logs"},"class":"list","resource":"LogEntry"},{"id":"delete_v2_messages","method":"delete","path":"/v2/messages","pathParams":[],"query":[{"name":"async","type":"boolean","required":false},{"name":"callerIp","type":"array","required":false},{"name":"callerIP","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"host","type":"array","required":false},{"name":"label","type":"array","required":false},{"name":"messageIds","type":"array","required":false},{"name":"path","type":"array","required":false},{"name":"queueName","type":"array","required":false},{"name":"scheduleId","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"topicName","type":"array","required":false},{"name":"url","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":202,"class":"action"},{"id":"get_v2_messages_messageid","method":"get","path":"/v2/messages/{messageId}","pathParams":["messageId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"delete_v2_messages_messageid","method":"delete","path":"/v2/messages/{messageId}","pathParams":["messageId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":202,"class":"delete"},{"id":"post_v2_messages_messageid_retry","method":"post","path":"/v2/messages/{messageId}/retry","pathParams":["messageId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"post_v2_notify_eventid","method":"post","path":"/v2/notify/{eventId}","pathParams":["eventId"],"query":[],"body":[],"bodyEncoding":"json","successStatus":201,"class":"non-resource"},{"id":"post_v2_notify_workflowrunid_eventid","method":"post","path":"/v2/notify/{workflowRunId}/{eventId}","pathParams":["workflowRunId","eventId"],"query":[],"body":[],"bodyEncoding":"json","successStatus":201,"answers":{"resource":"Waiter","list":false,"key":"waiter"},"class":"action","resource":"Waiter"},{"id":"post_v2_publish_destination","method":"post","path":"/v2/publish/{destination}","pathParams":["destination"],"query":[],"body":[],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"get_v2_queues","method":"get","path":"/v2/queues","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Queue","list":true},"class":"list","resource":"Queue"},{"id":"post_v2_queues","method":"post","path":"/v2/queues","pathParams":[],"query":[],"body":[{"name":"parallelism","type":"integer","required":true},{"name":"queueName","type":"string","required":true}],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"get_v2_queues_queuename","method":"get","path":"/v2/queues/{queueName}","pathParams":["queueName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Queue","list":false},"class":"retrieve","resource":"Queue"},{"id":"delete_v2_queues_queuename","method":"delete","path":"/v2/queues/{queueName}","pathParams":["queueName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete","resource":"Queue"},{"id":"post_v2_queues_queuename_pause","method":"post","path":"/v2/queues/{queueName}/pause","pathParams":["queueName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Queue"},{"id":"post_v2_queues_queuename_resume","method":"post","path":"/v2/queues/{queueName}/resume","pathParams":["queueName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Queue"},{"id":"get_v2_schedules","method":"get","path":"/v2/schedules","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Schedule","list":true},"class":"list","resource":"Schedule"},{"id":"post_v2_schedules_destination","method":"post","path":"/v2/schedules/{destination}","pathParams":["destination"],"query":[],"body":[],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"get_v2_schedules_scheduleid","method":"get","path":"/v2/schedules/{scheduleId}","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Schedule","list":false},"class":"retrieve","resource":"Schedule"},{"id":"delete_v2_schedules_scheduleid","method":"delete","path":"/v2/schedules/{scheduleId}","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete","resource":"Schedule"},{"id":"post_v2_schedules_scheduleid_pause","method":"post","path":"/v2/schedules/{scheduleId}/pause","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Schedule"},{"id":"patch_v2_schedules_scheduleid_pause","method":"patch","path":"/v2/schedules/{scheduleId}/pause","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Schedule"},{"id":"post_v2_schedules_scheduleid_resume","method":"post","path":"/v2/schedules/{scheduleId}/resume","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Schedule"},{"id":"patch_v2_schedules_scheduleid_resume","method":"patch","path":"/v2/schedules/{scheduleId}/resume","pathParams":["scheduleId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action","resource":"Schedule"},{"id":"get_v2_topics","method":"get","path":"/v2/topics","pathParams":[],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"URLGroup","list":true},"class":"list","resource":"URLGroup"},{"id":"get_v2_topics_urlgroupname","method":"get","path":"/v2/topics/{urlGroupName}","pathParams":["urlGroupName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"URLGroup","list":false},"class":"retrieve","resource":"URLGroup"},{"id":"delete_v2_topics_urlgroupname","method":"delete","path":"/v2/topics/{urlGroupName}","pathParams":["urlGroupName"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete","resource":"URLGroup"},{"id":"post_v2_topics_urlgroupname_endpoints","method":"post","path":"/v2/topics/{urlGroupName}/endpoints","pathParams":["urlGroupName"],"query":[],"body":[{"name":"endpoints","type":"array","required":true}],"bodyEncoding":"json","successStatus":200,"class":"action","resource":"URLGroup"},{"id":"delete_v2_topics_urlgroupname_endpoints","method":"delete","path":"/v2/topics/{urlGroupName}/endpoints","pathParams":["urlGroupName"],"query":[],"body":[{"name":"endpoints","type":"array","required":true}],"bodyEncoding":"json","successStatus":200,"class":"action","resource":"URLGroup"},{"id":"post_v2_trigger_workflowurl","method":"post","path":"/v2/trigger/{workflowUrl}","pathParams":["workflowUrl"],"query":[],"body":[],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"post_v2_wait_eventid","method":"post","path":"/v2/wait/{eventId}","pathParams":["eventId"],"query":[],"body":[{"name":"step","type":"object","required":false},{"name":"timeout","type":"string","required":false},{"name":"timeoutBody","type":"string","required":false},{"name":"timeoutHeaders","type":"object","required":false},{"name":"timeoutUrl","type":"string","required":false},{"name":"url","type":"string","required":false}],"bodyEncoding":"json","successStatus":200,"class":"non-resource"},{"id":"get_v2_waiters_eventid","method":"get","path":"/v2/waiters/{eventId}","pathParams":["eventId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Waiter","list":true},"class":"list","resource":"Waiter"},{"id":"get_v2_workflows_bulkactions","method":"get","path":"/v2/workflows/bulkActions","pathParams":[],"query":[{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"state","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"BulkAction","list":true,"key":"bulkActions"},"class":"list","resource":"BulkAction"},{"id":"get_v2_workflows_bulkactions_actionid","method":"get","path":"/v2/workflows/bulkActions/{actionId}","pathParams":["actionId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"BulkAction","list":false},"class":"retrieve","resource":"BulkAction"},{"id":"get_v2_workflows_dlq","method":"get","path":"/v2/workflows/dlq","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"failureFunctionState","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"workflowCreatedAt","type":"integer","required":false},{"name":"workflowRunId","type":"string","required":false},{"name":"workflowUrl","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"WorkflowDLQMessage","list":true,"key":"messages"},"class":"list","resource":"WorkflowDLQMessage"},{"id":"delete_v2_workflows_dlq","method":"delete","path":"/v2/workflows/dlq","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"dlqIds","type":"array","required":false},{"name":"failureFunctionState","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"workflowCreatedAt","type":"integer","required":false},{"name":"workflowRunId","type":"string","required":false},{"name":"workflowUrl","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action"},{"id":"get_v2_workflows_dlq_dlqid","method":"get","path":"/v2/workflows/dlq/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"WorkflowDLQMessage","list":false},"class":"retrieve","resource":"WorkflowDLQMessage"},{"id":"delete_v2_workflows_dlq_dlqid","method":"delete","path":"/v2/workflows/dlq/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete","resource":"WorkflowDLQMessage"},{"id":"post_v2_workflows_dlq_callback_dlqid","method":"post","path":"/v2/workflows/dlq/callback/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"delete_v2_workflows_dlq_callback_dlqid","method":"delete","path":"/v2/workflows/dlq/callback/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete"},{"id":"post_v2_workflows_dlq_restart","method":"post","path":"/v2/workflows/dlq/restart","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"dlqIds","type":"array","required":false},{"name":"failureFunctionState","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"workflowCreatedAt","type":"integer","required":false},{"name":"workflowRunId","type":"string","required":false},{"name":"workflowUrl","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"post_v2_workflows_dlq_restart_dlqid","method":"post","path":"/v2/workflows/dlq/restart/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"post_v2_workflows_dlq_resume","method":"post","path":"/v2/workflows/dlq/resume","pathParams":[],"query":[{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"dlqIds","type":"array","required":false},{"name":"failureFunctionState","type":"array","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"toDate","type":"integer","required":false},{"name":"workflowCreatedAt","type":"integer","required":false},{"name":"workflowRunId","type":"string","required":false},{"name":"workflowUrl","type":"array","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"post_v2_workflows_dlq_resume_dlqid","method":"post","path":"/v2/workflows/dlq/resume/{dlqId}","pathParams":["dlqId"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"class":"non-resource"},{"id":"get_v2_workflows_logs","method":"get","path":"/v2/workflows/logs","pathParams":[],"query":[{"name":"callerIp","type":"string","required":false},{"name":"count","type":"integer","required":false},{"name":"cursor","type":"string","required":false},{"name":"flowControlKey","type":"string","required":false},{"name":"fromDate","type":"integer","required":false},{"name":"label","type":"array","required":false},{"name":"state","type":"string","required":false},{"name":"toDate","type":"integer","required":false},{"name":"trimBody","type":"integer","required":false},{"name":"workflowCreatedAt","type":"integer","required":false},{"name":"workflowRunId","type":"string","required":false},{"name":"workflowRuns","type":"string","required":false},{"name":"workflowUrl","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"WorkflowRun","list":true,"key":"runs"},"class":"list","resource":"WorkflowRun"},{"id":"delete_v2_workflows_runs","method":"delete","path":"/v2/workflows/runs","pathParams":[],"query":[{"name":"async","type":"boolean","required":false},{"name":"callerIp","type":"array","required":false},{"name":"count","type":"integer","required":false},{"name":"flowControlKey","type":"array","required":false},{"name":"fromDate","type":"number","required":false},{"name":"host","type":"array","required":false},{"name":"label","type":"array","required":false},{"name":"path","type":"array","required":false},{"name":"toDate","type":"number","required":false},{"name":"workflowRunIds","type":"array","required":false},{"name":"workflowUrl","type":"array","required":false},{"name":"workflowUrlExactMatch","type":"boolean","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"action"},{"id":"delete_v2_workflows_runs_workflowrunid","method":"delete","path":"/v2/workflows/runs/{workflowRunId}","pathParams":["workflowRunId"],"query":[{"name":"cancel","type":"boolean","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"delete"}]}

package/dist/qstash/src/generated/ui.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","resources":{"Message":{"actions":[],"states":{"state":["ACTIVE","CANCELLED","CANCEL_REQUESTED","CREATED","DELIVERED","FAILED","RETRY"]},"embeds":{}},"Queue":{"retrieve":"/v2/queues/{queueName}","actions":[],"states":{},"embeds":{}},"Schedule":{"actions":[{"operation":"post_v2_schedules_scheduleid_pause","method":"POST","path":"/v2/schedules/{scheduleId}/pause","field":"isPaused","from":["true"]},{"operation":"post_v2_schedules_scheduleid_pause","method":"POST","path":"/v2/schedules/{scheduleId}/pause","field":"isPaused","from":["false"],"to":"true"},{"operation":"patch_v2_schedules_scheduleid_pause","method":"PATCH","path":"/v2/schedules/{scheduleId}/pause","field":"isPaused","from":["true"]},{"operation":"patch_v2_schedules_scheduleid_pause","method":"PATCH","path":"/v2/schedules/{scheduleId}/pause","field":"isPaused","from":["false"],"to":"true"}],"states":{"isPaused":["false","true"]},"embeds":{}},"URLGroup":{"list":"/v2/topics","retrieve":"/v2/topics/{urlGroupName}","actions":[],"states":{},"embeds":{}},"DLQMessage":{"actions":[],"states":{},"embeds":{}},"WorkflowRun":{"actions":[],"states":{"workflowState":["RUN_CANCELED","RUN_FAILED","RUN_STARTED","RUN_SUCCESS"]},"embeds":{}},"WorkflowDLQMessage":{"list":"/v2/workflows/dlq","actions":[],"states":{},"embeds":{}},"Waiter":{"actions":[],"states":{},"embeds":{}}}}

package/dist/qstash/src/index.ts

@@ -0,0 +1,35 @@
+// The QStash lane of the upstash pack (QStash and Upstash Workflow, one API in two documents), as a plain fetch: the
+// whole pack's fetch (the Redis REST wire, the Developer API and console at api.upstash.com and console.upstash.com, and
+// QStash), whose owners are the operations this lane serves. Its life walks through them: a customer signs in to the
+// console for its QStash token and keys, and publishes, schedules, queues and runs workflows through QStash's API
+// (journeys/customer-life.outline.md).
+import type { DerivedFetch } from '@volter/world-core';
+import { createUpstashRedisTwinFetch } from '../../src/upstash-server.ts';
+import { createQstashLaneFetch, type QstashLaneOptions } from './fetch.ts';
+
+export { manifest } from './manifest.ts';
+export { createQstashLaneFetch } from './fetch.ts';
+
+export function createQstashTwinFetch(options: QstashLaneOptions = {}): DerivedFetch {
+  const lane = createQstashLaneFetch(options);
+  const pack = createUpstashRedisTwinFetch({ ...(options.root !== undefined ? { root: options.root } : {}), ...(options.readOnly !== undefined ? { readOnly: options.readOnly } : {}), qstash: lane });
+  return Object.assign((request: Request) => pack(request), { owners: () => lane.owners() });
+}
+
+/** The pack's views of the lane's answers, for a journey step's `view` (scripts/journey-kit.ts). `steps`: the deliveries
+ *  door's answer with each workflow delivery's body read as `serve()` reads it: its steps, each step's published body
+ *  decoded from base64 (and parsed, where it is JSON). */
+export const answerViews: Record<string, (body: unknown) => unknown> = {
+  steps: (body) => {
+    const b = body as { deliveries?: Array<Record<string, unknown>> };
+    const decode = (s: string): unknown => { const t = Buffer.from(s, 'base64').toString('utf8'); try { return JSON.parse(t); } catch { return t; } };
+    return {
+      ...b,
+      deliveries: (b.deliveries ?? []).map((d) => {
+        let raw: unknown;
+        try { raw = JSON.parse(String(d.body)); } catch { return d; }
+        return Array.isArray(raw) ? { ...d, steps: raw.map((r: Record<string, unknown>) => ({ ...r, body: decode(String(r.body ?? '')) })) } : d;
+      }),
+    };
+  },
+};

package/dist/qstash/src/manifest.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedManifest } from '@volter/world-core';
+/** The path parameters whose values hold slashes: a destination is a whole URL (`/v2/publish/https://example.com/x`). */
+export declare const spanning: string[];
+/** The hosts the lane serves: "https://qstash-{region}.upstash.io" with the regions us-east-1 and eu-central-1 (both
+ *  documents' `servers`), and qstash.upstash.io, the host Upstash's pages send their examples to. An application pointed at
+ *  the World through QSTASH_URL reaches the lane at the pack's own address instead. SHAPE judges the lane's life on these. */
+export declare const hosts: {
+    host: string;
+}[];
+export declare const manifest: DerivedManifest;