xquik-convex 0.2.0 → 0.2.1

package/dist/component/events.js

@@ -1,38 +1,42 @@
-import { paginationOptsValidator, paginationResultValidator } from "convex/server";
-import { v } from "convex/values";
 import { env, query } from "./_generated/server.js";
-import { requireApiKey } from "./access.js";
+import { paginationOptsValidator, paginationResultValidator } from "convex/server";
+import requireApiKey from "./access.js";
 import schema from "./schema.js";
-export const eventDoc = schema.tables.events.validator.extend({
-    _id: v.id("events"),
+import { v } from "convex/values";
+const eventDoc = schema.tables.events.validator.extend({
     _creationTime: v.number(),
+    _id: v.id("events"),
 });
-export const list = query({
+const eventFilter = v.union(v.object({ eventType: v.string() }), v.object({ monitorId: v.string() }));
+const list = query({
     args: {
+        filter: v.optional(eventFilter),
         paginationOpts: paginationOptsValidator,
-        filter: v.optional(v.union(v.object({ eventType: v.string() }), v.object({ monitorId: v.string() }))),
     },
-    returns: paginationResultValidator(eventDoc),
-    handler: async (ctx, { paginationOpts, filter }) => {
+    handler: async (ctx, { filter, paginationOpts }) => {
         requireApiKey(env.XQUIK_API_KEY);
         const events = ctx.db.query("events");
-        const ordered = filter === undefined
-            ? events.withIndex("by_occurred")
-            : "eventType" in filter
-                ? events.withIndex("by_type", (q) => q.eq("eventType", filter.eventType))
-                : events.withIndex("by_monitor", (q) => q.eq("monitorId", filter.monitorId));
+        let ordered = events.withIndex("by_occurred");
+        if (typeof filter === "object" && "eventType" in filter) {
+            ordered = events.withIndex("by_type", (range) => range.eq("eventType", filter.eventType));
+        }
+        if (typeof filter === "object" && "monitorId" in filter) {
+            ordered = events.withIndex("by_monitor", (range) => range.eq("monitorId", filter.monitorId));
+        }
         return await ordered.order("desc").paginate(paginationOpts);
     },
+    returns: paginationResultValidator(eventDoc),
 });
-export const get = query({
+const get = query({
     args: { streamEventId: v.string() },
-    returns: v.union(v.null(), eventDoc),
     handler: async (ctx, { streamEventId }) => {
         requireApiKey(env.XQUIK_API_KEY);
         return await ctx.db
             .query("events")
-            .withIndex("by_stream_event", (q) => q.eq("streamEventId", streamEventId))
+            .withIndex("by_stream_event", (range) => range.eq("streamEventId", streamEventId))
             .unique();
     },
+    returns: v.union(v.null(), eventDoc),
 });
+export { get, list };
 //# sourceMappingURL=events.js.map

package/dist/component/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/component/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IAC5D,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;IACnB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;IACxB,IAAI,EAAE;QACJ,cAAc,EAAE,uBAAuB;QACvC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;KACtG;IACD,OAAO,EAAE,yBAAyB,CAAC,QAAQ,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC;YACjC,CAAC,CAAC,WAAW,IAAI,MAAM;gBACrB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;gBACzE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACnF,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QACxC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,OAAO,MAAM,GAAG,CAAC,EAAE;aAChB,KAAK,CAAC,QAAQ,CAAC;aACf,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;aACzE,MAAM,EAAE,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/component/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,aAAa,MAAM,aAAa,CAAC;AACxC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAEtG,MAAM,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC/B,cAAc,EAAE,uBAAuB;KACxC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;QACjD,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;YACxD,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;YACxD,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,yBAAyB,CAAC,QAAQ,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACnC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QACxC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,OAAO,MAAM,GAAG,CAAC,EAAE;aAChB,KAAK,CAAC,QAAQ,CAAC;aACf,SAAS,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;aACjF,MAAM,EAAE,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC;CACrC,CAAC,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC"}

package/dist/component/http.d.ts

@@ -1,4 +1,4 @@
-export declare const receive: import("convex/server").PublicHttpAction;
-declare const http: import("convex/server").HttpRouter;
-export default http;
+import type { HttpRouter } from "convex/server";
+declare const _default: HttpRouter;
+export default _default;
 //# sourceMappingURL=http.d.ts.map

package/dist/component/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO,0CAelB,CAAC;AAEH,QAAA,MAAM,IAAI,oCAAe,CAAC;AAI1B,eAAe,IAAI,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;;AA+DhD,wBAAwB"}

package/dist/component/http.js

@@ -1,30 +1,53 @@
+import { check, readDelivery } from "./delivery.js";
+import { httpAction } from "./_generated/server.js";
 import { httpRouter } from "convex/server";
 import { internal } from "./_generated/api.js";
-import { httpAction } from "./_generated/server.js";
-import { check, readDelivery } from "./delivery.js";
+const OK = 200;
+const BAD_REQUEST = 400;
+const UNAUTHORIZED = 401;
+const NOT_FOUND = 404;
+const SLASH = "/";
 function reply(status, text) {
-    return new Response(text, { status, headers: { "content-type": "text/plain" } });
+    return new Response(text, { headers: { "content-type": "text/plain" }, status });
 }
-export const receive = httpAction(async (ctx, request) => {
-    const path = new URL(request.url).pathname;
-    const endpoint = await ctx.runQuery(internal.webhooks.endpoint, { token: path.slice(path.lastIndexOf("/") + 1) });
-    if (endpoint === null)
-        return reply(404, "unknown webhook URL");
-    const body = await request.arrayBuffer();
-    const verdict = await check(endpoint.secret, request.headers, body, Date.now());
-    if (!verdict.ok)
-        return reply(401, verdict.reason);
+function tokenOf(url) {
+    const { pathname } = new URL(url);
+    return pathname.slice(pathname.lastIndexOf(SLASH) + SLASH.length);
+}
+async function admit(secret, headers, body) {
+    const verdict = await check(secret, headers, body, Date.now());
+    if (!verdict.ok) {
+        return { ok: false, reason: verdict.reason, status: UNAUTHORIZED };
+    }
     const delivery = readDelivery(new TextDecoder().decode(body));
-    if (delivery === null)
-        return reply(400, "not an Xquik delivery");
-    const outcome = await ctx.runMutation(internal.webhooks.ingest, {
-        endpointId: endpoint._id,
-        nonce: verdict.nonce,
-        event: delivery.kind === "test" ? null : delivery.event,
-    });
-    return outcome === "replay" ? reply(401, "replayed nonce") : reply(200, outcome);
+    if (delivery.kind === "invalid") {
+        return { ok: false, reason: "not an Xquik delivery", status: BAD_REQUEST };
+    }
+    return { delivery, nonce: verdict.nonce, ok: true };
+}
+function answer(outcome) {
+    if (outcome === "replay") {
+        return reply(UNAUTHORIZED, "replayed nonce");
+    }
+    return reply(OK, outcome);
+}
+const receive = httpAction(async (ctx, request) => {
+    const endpoint = await ctx.runQuery(internal.webhooks.endpoint, { token: tokenOf(request.url) });
+    if (endpoint === null) {
+        return reply(NOT_FOUND, "unknown webhook URL");
+    }
+    const admission = await admit(endpoint.secret, request.headers, await request.arrayBuffer());
+    if (!admission.ok) {
+        return reply(admission.status, admission.reason);
+    }
+    const { _id: endpointId } = endpoint;
+    const { delivery, nonce } = admission;
+    return answer(await ctx.runMutation(internal.webhooks.ingest, { delivery, endpointId, nonce }));
 });
-const http = httpRouter();
-http.route({ pathPrefix: "/webhooks/", method: "POST", handler: receive });
-export default http;
+function router() {
+    const http = httpRouter();
+    http.route({ handler: receive, method: "POST", pathPrefix: "/webhooks/" });
+    return http;
+}
+export default router();
 //# sourceMappingURL=http.js.map

package/dist/component/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAkB,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpD,SAAS,KAAK,CAAC,MAAc,EAAE,IAAY;IACzC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,GAAc,EAAE,OAAgB,EAAqB,EAAE;IAC9F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAClH,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC9D,UAAU,EAAE,QAAQ,CAAC,GAAG;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;KACxD,CAAC,CAAC;IACH,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACnF,CAAC,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;AAE1B,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAE3E,eAAe,IAAI,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/component/http.ts"],"names":[],"mappings":"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"}

package/dist/component/job.d.ts

@@ -0,0 +1,101 @@
+import type { Infer, Value } from "convex/values";
+import type { jobStatus } from "./schema.js";
+import type { Operation } from "./shape.js";
+declare const jobDoc: import("convex/values").VObject<{
+    key?: string;
+    error?: Value;
+    everyMs?: number;
+    result?: Value;
+    scheduledId?: import("convex/values").GenericId<"_scheduled_functions">;
+    status: "failed" | "succeeded" | "canceled" | "scheduled";
+    args: Record<string, Value>;
+    operation: string;
+    attempts: number;
+    runs: number;
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"jobs">;
+}, {
+    args: import("convex/values").VRecord<Record<string, Value>, import("convex/values").VString<string, "required">, import("convex/values").Validator<Value, "required", string>, "required", string>;
+    attempts: import("convex/values").VFloat64<number, "required">;
+    error: import("convex/values").VId<Value | undefined, "optional"> | import("convex/values").VString<Value | undefined, "optional"> | import("convex/values").VFloat64<Value | undefined, "optional"> | import("convex/values").VInt64<Value | undefined, "optional"> | import("convex/values").VCommitTs<Value | undefined, "optional"> | import("convex/values").VBoolean<Value | undefined, "optional"> | import("convex/values").VNull<Value | undefined, "optional"> | import("convex/values").VAny<Value | undefined, "optional", string> | import("convex/values").VLiteral<Value | undefined, "optional"> | import("convex/values").VBytes<Value | undefined, "optional"> | import("convex/values").VObject<Value | undefined, Record<string, import("convex/values").Validator<any, import("convex/values").OptionalProperty, any>>, "optional", string> | import("convex/values").VArray<Value | undefined, import("convex/values").Validator<any, "required", any>, "optional"> | import("convex/values").VRecord<Value | undefined, import("convex/values").Validator<string, "required", any>, import("convex/values").Validator<any, "required", any>, "optional", string> | import("convex/values").VUnion<Value | undefined, import("convex/values").Validator<any, "required", any>[], "optional", string>;
+    everyMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    key: import("convex/values").VString<string | undefined, "optional">;
+    operation: import("convex/values").VString<string, "required">;
+    result: import("convex/values").VId<Value | undefined, "optional"> | import("convex/values").VString<Value | undefined, "optional"> | import("convex/values").VFloat64<Value | undefined, "optional"> | import("convex/values").VInt64<Value | undefined, "optional"> | import("convex/values").VCommitTs<Value | undefined, "optional"> | import("convex/values").VBoolean<Value | undefined, "optional"> | import("convex/values").VNull<Value | undefined, "optional"> | import("convex/values").VAny<Value | undefined, "optional", string> | import("convex/values").VLiteral<Value | undefined, "optional"> | import("convex/values").VBytes<Value | undefined, "optional"> | import("convex/values").VObject<Value | undefined, Record<string, import("convex/values").Validator<any, import("convex/values").OptionalProperty, any>>, "optional", string> | import("convex/values").VArray<Value | undefined, import("convex/values").Validator<any, "required", any>, "optional"> | import("convex/values").VRecord<Value | undefined, import("convex/values").Validator<string, "required", any>, import("convex/values").Validator<any, "required", any>, "optional", string> | import("convex/values").VUnion<Value | undefined, import("convex/values").Validator<any, "required", any>[], "optional", string>;
+    runs: import("convex/values").VFloat64<number, "required">;
+    scheduledId: import("convex/values").VId<import("convex/values").GenericId<"_scheduled_functions"> | undefined, "optional">;
+    status: import("convex/values").VUnion<"failed" | "succeeded" | "canceled" | "scheduled", [import("convex/values").VLiteral<"scheduled", "required">, import("convex/values").VLiteral<"succeeded", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    _id: import("convex/values").VId<import("convex/values").GenericId<"jobs">, "required">;
+}, "required", "key" | "error" | "status" | "_creationTime" | "_id" | "args" | "everyMs" | "operation" | "result" | "attempts" | "runs" | "scheduledId" | `error.${string}` | `args.${string}` | `result.${string}`>;
+declare const failure: import("convex/values").VObject<{
+    retryAfterMs?: number;
+    error: Value;
+    ok: false;
+    retryable: boolean;
+}, {
+    error: import("convex/values").Validator<Value, "required", string>;
+    ok: import("convex/values").VLiteral<false, "required">;
+    retryAfterMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    retryable: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "error" | "ok" | `error.${string}` | "retryAfterMs" | "retryable">;
+declare const outcome: import("convex/values").VUnion<{
+    ok: true;
+    result: Value;
+} | {
+    retryAfterMs?: number;
+    error: Value;
+    ok: false;
+    retryable: boolean;
+}, [import("convex/values").VObject<{
+    ok: true;
+    result: Value;
+}, {
+    ok: import("convex/values").VLiteral<true, "required">;
+    result: import("convex/values").Validator<Value, "required", string>;
+}, "required", "ok" | "result" | `result.${string}`>, import("convex/values").VObject<{
+    retryAfterMs?: number;
+    error: Value;
+    ok: false;
+    retryable: boolean;
+}, {
+    error: import("convex/values").Validator<Value, "required", string>;
+    ok: import("convex/values").VLiteral<false, "required">;
+    retryAfterMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    retryable: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "error" | "ok" | `error.${string}` | "retryAfterMs" | "retryable">], "required", "error" | "ok" | "result" | `error.${string}` | `result.${string}` | "retryAfterMs" | "retryable">;
+type Outcome = Infer<typeof outcome>;
+type Failure = Infer<typeof failure>;
+type Attempt = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly retryAfterMs?: number;
+    readonly retryable: boolean;
+};
+interface Plan {
+    readonly status: Infer<typeof jobStatus>;
+    readonly delayMs?: number;
+    readonly attempts: number;
+}
+declare function plan(job: {
+    readonly attempts: number;
+    readonly everyMs?: number;
+}, result: Attempt): Plan;
+declare function runsAfter(runs: number, next: Plan): number;
+declare function isScheduled(job: {
+    readonly status: string;
+} | null): job is {
+    readonly status: "scheduled";
+};
+declare function isLive(scheduled: {
+    readonly state: {
+        readonly kind: string;
+    };
+} | null): boolean;
+declare function requireInterval(everyMs: number | undefined): void;
+declare function unexpected(id: string): Failure;
+declare function failed(definition: Operation, error: unknown): Failure;
+export { failed, isLive, isScheduled, jobDoc, outcome, plan, requireInterval, runsAfter, unexpected };
+export type { Attempt, Failure, Outcome, Plan };
+//# sourceMappingURL=job.d.ts.map

package/dist/component/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/component/job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAe5C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;oNAAwF,CAAC;AAGrG,QAAA,MAAM,OAAO;;;;;;;;;;iFAKX,CAAC;AACH,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;kMAA4B,CAAC;AAE1C,KAAK,OAAO,GAAG,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AACrC,KAAK,OAAO,GAAG,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AACrC,KAAK,OAAO,GACV;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9G,UAAU,IAAI;IACZ,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iBAAS,IAAI,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAelG;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAKnD;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,GAAG,IAAI;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAKrG;AAED,iBAAS,MAAM,CAAC,SAAS,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,GAAG,OAAO,CAKxF;AAED,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQ1D;AAwBD,iBAAS,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGvC;AAED,iBAAS,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACtG,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/component/job.js

@@ -0,0 +1,102 @@
+import { ConvexError, v } from "convex/values";
+import { isRecord } from "./shape.js";
+import { json } from "./values.js";
+import schema from "./schema.js";
+const MAX_ATTEMPTS = 5;
+const MIN_EVERY_MS = 60_000;
+const ONE_ATTEMPT = 1;
+const ONE_RUN = 1;
+const NO_RETRIES = 0;
+const FIRST_DELAY_MS = 1000;
+const BACKOFF = 2;
+const MS_PER_SECOND = 1000;
+const TOO_MANY_REQUESTS = 429;
+const SERVER_ERROR = 500;
+const LIVE = new Set(["inProgress", "pending"]);
+const jobDoc = schema.tables.jobs.validator.extend({ _creationTime: v.number(), _id: v.id("jobs") });
+const success = v.object({ ok: v.literal(true), result: json });
+const failure = v.object({
+    error: json,
+    ok: v.literal(false),
+    retryAfterMs: v.optional(v.number()),
+    retryable: v.boolean(),
+});
+const outcome = v.union(success, failure);
+function plan(job, result) {
+    if (!result.ok && result.retryable && job.attempts + ONE_ATTEMPT < MAX_ATTEMPTS) {
+        return {
+            attempts: job.attempts + ONE_ATTEMPT,
+            delayMs: result.retryAfterMs ?? FIRST_DELAY_MS * BACKOFF ** job.attempts,
+            status: "scheduled",
+        };
+    }
+    if (typeof job.everyMs === "number") {
+        return { attempts: 0, delayMs: job.everyMs, status: "scheduled" };
+    }
+    if (result.ok) {
+        return { attempts: 0, status: "succeeded" };
+    }
+    return { attempts: 0, status: "failed" };
+}
+function runsAfter(runs, next) {
+    if (next.attempts === NO_RETRIES) {
+        return runs + ONE_RUN;
+    }
+    return runs;
+}
+function isScheduled(job) {
+    if (job === null) {
+        return false;
+    }
+    return job.status === "scheduled";
+}
+function isLive(scheduled) {
+    if (scheduled === null) {
+        return false;
+    }
+    return LIVE.has(scheduled.state.kind);
+}
+function requireInterval(everyMs) {
+    if ((everyMs ?? MIN_EVERY_MS) < MIN_EVERY_MS) {
+        throw new ConvexError({
+            error: "interval_too_short",
+            message: `Set everyMs to ${String(MIN_EVERY_MS)} or more.`,
+            status: 400,
+        });
+    }
+}
+function keyed(definition) {
+    return definition.params.some((param) => param.name === "idempotencyKey");
+}
+function isConvexError(error) {
+    return error instanceof ConvexError;
+}
+function errorData(error) {
+    if (isConvexError(error)) {
+        return error.data;
+    }
+    return { message: String(error) };
+}
+function asRecord(data) {
+    if (isRecord(data)) {
+        return data;
+    }
+    return {};
+}
+function unexpected(id) {
+    const message = `Xquik answered ${id} with a result its schema does not allow.`;
+    return { error: { error: "unexpected_result", message, status: 502 }, ok: false, retryable: false };
+}
+function failed(definition, error) {
+    const data = errorData(error);
+    const { retryAfter, status } = asRecord(data);
+    const safe = definition.method === "GET" || keyed(definition);
+    const transient = typeof status !== "number" || status === TOO_MANY_REQUESTS || status >= SERVER_ERROR;
+    const retryable = safe && transient;
+    if (typeof retryAfter === "number") {
+        return { error: data, ok: false, retryAfterMs: retryAfter * MS_PER_SECOND, retryable };
+    }
+    return { error: data, ok: false, retryable };
+}
+export { failed, isLive, isScheduled, jobDoc, outcome, plan, requireInterval, runsAfter, unexpected };
+//# sourceMappingURL=job.js.map

package/dist/component/job.js.map

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

package/dist/component/jobs.d.ts

@@ -1,133 +1,62 @@
-import { type Infer, type Value } from "convex/values";
-import type { Id } from "./_generated/dataModel.js";
-import { jobStatus } from "./schema.js";
-import { type Operation } from "./shape.js";
-export declare const MAX_ATTEMPTS = 5;
-export declare const MIN_EVERY_MS = 60000;
-export declare const jobDoc: import("convex/values").VObject<{
-    key?: string;
-    error?: Value;
-    everyMs?: number;
-    result?: Value;
-    scheduledId?: import("convex/values").GenericId<"_scheduled_functions">;
-    status: "failed" | "succeeded" | "canceled" | "scheduled";
-    args: Record<string, Value>;
-    operation: string;
-    attempts: number;
-    runs: number;
-    _creationTime: number;
-    _id: import("convex/values").GenericId<"jobs">;
-}, {
-    key: import("convex/values").VString<string | undefined, "optional">;
-    operation: import("convex/values").VString<string, "required">;
-    args: import("convex/values").VRecord<Record<string, Value>, import("convex/values").VString<string, "required">, import("convex/values").Validator<Value, "required", string>, "required", string>;
-    everyMs: import("convex/values").VFloat64<number | undefined, "optional">;
-    status: import("convex/values").VUnion<"failed" | "succeeded" | "canceled" | "scheduled", [import("convex/values").VLiteral<"scheduled", "required">, import("convex/values").VLiteral<"succeeded", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
-    attempts: import("convex/values").VFloat64<number, "required">;
-    runs: import("convex/values").VFloat64<number, "required">;
-    scheduledId: import("convex/values").VId<import("convex/values").GenericId<"_scheduled_functions"> | undefined, "optional">;
-    result: import("convex/values").VId<Value | undefined, "optional"> | import("convex/values").VString<Value | undefined, "optional"> | import("convex/values").VFloat64<Value | undefined, "optional"> | import("convex/values").VInt64<Value | undefined, "optional"> | import("convex/values").VCommitTs<Value | undefined, "optional"> | import("convex/values").VBoolean<Value | undefined, "optional"> | import("convex/values").VNull<Value | undefined, "optional"> | import("convex/values").VAny<Value | undefined, "optional", string> | import("convex/values").VLiteral<Value | undefined, "optional"> | import("convex/values").VBytes<Value | undefined, "optional"> | import("convex/values").VObject<Value | undefined, Record<string, import("convex/values").Validator<any, import("convex/values").OptionalProperty, any>>, "optional", string> | import("convex/values").VArray<Value | undefined, import("convex/values").Validator<any, "required", any>, "optional"> | import("convex/values").VRecord<Value | undefined, import("convex/values").Validator<string, "required", any>, import("convex/values").Validator<any, "required", any>, "optional", string> | import("convex/values").VUnion<Value | undefined, import("convex/values").Validator<any, "required", any>[], "optional", string>;
-    error: import("convex/values").VId<Value | undefined, "optional"> | import("convex/values").VString<Value | undefined, "optional"> | import("convex/values").VFloat64<Value | undefined, "optional"> | import("convex/values").VInt64<Value | undefined, "optional"> | import("convex/values").VCommitTs<Value | undefined, "optional"> | import("convex/values").VBoolean<Value | undefined, "optional"> | import("convex/values").VNull<Value | undefined, "optional"> | import("convex/values").VAny<Value | undefined, "optional", string> | import("convex/values").VLiteral<Value | undefined, "optional"> | import("convex/values").VBytes<Value | undefined, "optional"> | import("convex/values").VObject<Value | undefined, Record<string, import("convex/values").Validator<any, import("convex/values").OptionalProperty, any>>, "optional", string> | import("convex/values").VArray<Value | undefined, import("convex/values").Validator<any, "required", any>, "optional"> | import("convex/values").VRecord<Value | undefined, import("convex/values").Validator<string, "required", any>, import("convex/values").Validator<any, "required", any>, "optional", string> | import("convex/values").VUnion<Value | undefined, import("convex/values").Validator<any, "required", any>[], "optional", string>;
-    _id: import("convex/values").VId<import("convex/values").GenericId<"jobs">, "required">;
-    _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "key" | "error" | "status" | "_creationTime" | "_id" | "args" | "everyMs" | "operation" | "result" | "attempts" | "runs" | "scheduledId" | `error.${string}` | `args.${string}` | `result.${string}`>;
-declare const outcome: import("convex/values").VUnion<{
-    ok: true;
-    result: Value;
-} | {
-    retryAfterMs?: number;
-    error: Value;
-    ok: false;
-    retryable: boolean;
-}, [import("convex/values").VObject<{
-    ok: true;
-    result: Value;
-}, {
-    ok: import("convex/values").VLiteral<true, "required">;
-    result: import("convex/values").Validator<Value, "required", string>;
-}, "required", "ok" | "result" | `result.${string}`>, import("convex/values").VObject<{
-    retryAfterMs?: number;
-    error: Value;
-    ok: false;
-    retryable: boolean;
-}, {
-    ok: import("convex/values").VLiteral<false, "required">;
-    error: import("convex/values").Validator<Value, "required", string>;
-    retryable: import("convex/values").VBoolean<boolean, "required">;
-    retryAfterMs: import("convex/values").VFloat64<number | undefined, "optional">;
-}, "required", "error" | "ok" | `error.${string}` | "retryable" | "retryAfterMs">], "required", "error" | "ok" | "result" | `error.${string}` | `result.${string}` | "retryable" | "retryAfterMs">;
-export type Outcome = Infer<typeof outcome>;
-export interface Plan {
-    readonly status: Infer<typeof jobStatus>;
-    readonly delayMs: number | null;
-    readonly attempts: number;
-}
-export declare function plan(job: {
-    readonly attempts: number;
-    readonly everyMs?: number;
-}, result: Outcome): Plan;
-export declare function checked(id: string, definition: Operation, value: Value): Outcome;
-export declare function failed(definition: Operation, error: unknown): Extract<Outcome, {
-    ok: false;
-}>;
-export declare const enqueue: import("convex/server").RegisteredMutation<"public", {
+import type { GenericId } from "convex/values";
+declare const enqueue: import("convex/server").RegisteredMutation<"public", {
     key?: string;
     delayMs?: number;
     everyMs?: number;
-    args: Record<string, Value>;
+    args: Record<string, import("convex/values").Value>;
     operation: string;
-}, Promise<Id<"jobs">>>;
-export declare const load: import("convex/server").RegisteredQuery<"internal", {
-    jobId: import("convex/values").GenericId<"jobs">;
+}, Promise<GenericId<"jobs">>>;
+declare const load: import("convex/server").RegisteredQuery<"internal", {
+    jobId: GenericId<"jobs">;
 }, Promise<{
-    _id: import("convex/values").GenericId<"jobs">;
+    _id: GenericId<"jobs">;
     _creationTime: number;
     key?: string;
-    error?: Value;
+    error?: import("convex/values").Value;
     everyMs?: number;
-    result?: Value;
-    scheduledId?: import("convex/values").GenericId<"_scheduled_functions">;
+    result?: import("convex/values").Value;
+    scheduledId?: GenericId<"_scheduled_functions">;
     status: "failed" | "succeeded" | "canceled" | "scheduled";
-    args: Record<string, Value>;
+    args: Record<string, import("convex/values").Value>;
     operation: string;
     attempts: number;
     runs: number;
 } | null>>;
-export declare const run: import("convex/server").RegisteredAction<"internal", {
-    jobId: import("convex/values").GenericId<"jobs">;
-}, Promise<null>>;
-export declare const finish: import("convex/server").RegisteredMutation<"internal", {
-    jobId: import("convex/values").GenericId<"jobs">;
+declare const run: import("convex/server").RegisteredAction<"internal", {
+    jobId: GenericId<"jobs">;
+}, Promise<void>>;
+declare const finish: import("convex/server").RegisteredMutation<"internal", {
+    jobId: GenericId<"jobs">;
     outcome: {
         ok: true;
-        result: Value;
+        result: import("convex/values").Value;
     } | {
         retryAfterMs?: number;
-        error: Value;
+        error: import("convex/values").Value;
         ok: false;
         retryable: boolean;
     };
-}, Promise<null>>;
-export declare const cancel: import("convex/server").RegisteredMutation<"public", {
-    jobId: import("convex/values").GenericId<"jobs">;
-}, Promise<null>>;
-export declare const get: import("convex/server").RegisteredQuery<"public", {
-    jobId: import("convex/values").GenericId<"jobs">;
+}, Promise<void>>;
+declare const cancel: import("convex/server").RegisteredMutation<"public", {
+    jobId: GenericId<"jobs">;
+}, Promise<void>>;
+declare const get: import("convex/server").RegisteredQuery<"public", {
+    jobId: GenericId<"jobs">;
 }, Promise<{
-    _id: import("convex/values").GenericId<"jobs">;
+    _id: GenericId<"jobs">;
     _creationTime: number;
     key?: string;
-    error?: Value;
+    error?: import("convex/values").Value;
     everyMs?: number;
-    result?: Value;
-    scheduledId?: import("convex/values").GenericId<"_scheduled_functions">;
+    result?: import("convex/values").Value;
+    scheduledId?: GenericId<"_scheduled_functions">;
     status: "failed" | "succeeded" | "canceled" | "scheduled";
-    args: Record<string, Value>;
+    args: Record<string, import("convex/values").Value>;
     operation: string;
     attempts: number;
     runs: number;
 } | null>>;
-export declare const list: import("convex/server").RegisteredQuery<"public", {
+declare const list: import("convex/server").RegisteredQuery<"public", {
     status?: "failed" | "succeeded" | "canceled" | "scheduled";
     paginationOpts: {
         id?: number;
@@ -138,18 +67,18 @@ export declare const list: import("convex/server").RegisteredQuery<"public", {
         cursor: string | null;
     };
 }, Promise<import("convex/server").PaginationResult<{
-    _id: import("convex/values").GenericId<"jobs">;
+    _id: GenericId<"jobs">;
     _creationTime: number;
     key?: string;
-    error?: Value;
+    error?: import("convex/values").Value;
     everyMs?: number;
-    result?: Value;
-    scheduledId?: import("convex/values").GenericId<"_scheduled_functions">;
+    result?: import("convex/values").Value;
+    scheduledId?: GenericId<"_scheduled_functions">;
     status: "failed" | "succeeded" | "canceled" | "scheduled";
-    args: Record<string, Value>;
+    args: Record<string, import("convex/values").Value>;
     operation: string;
     attempts: number;
     runs: number;
 }>>>;
-export {};
+export { cancel, enqueue, finish, get, list, load, run };
 //# sourceMappingURL=jobs.d.ts.map

package/dist/component/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/component/jobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AAKpD,OAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAItD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,YAAY,QAAS,CAAC;AAEnC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;oNAAwF,CAAC;AAE5G,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;kMAGZ,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE5C,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAUzG;AAUD,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAIhF;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAW7F;AAED,eAAO,MAAM,OAAO;;;;;;uBA2ClB,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;UAIf,CAAC;AAEH,eAAO,MAAM,GAAG;;iBAed,CAAC;AAEH,eAAO,MAAM,MAAM;;;;;;;;;;;iBAqBjB,CAAC;AAEH,eAAO,MAAM,MAAM;;iBAWjB,CAAC;AAEH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;UAOd,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;IASf,CAAC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/component/jobs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAS/C,QAAA,MAAM,OAAO;;;;;;8BAkDX,CAAC;AAEH,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;UAIR,CAAC;AAEH,QAAA,MAAM,GAAG;;iBAqBP,CAAC;AAEH,QAAA,MAAM,MAAM;;;;;;;;;;;iBA0CV,CAAC;AAEH,QAAA,MAAM,MAAM;;iBAgBV,CAAC;AAEH,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;UAOP,CAAC;AAEH,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;IAcR,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC"}