helloruntime 0.0.1

package/dist/sdk/db.js

@@ -0,0 +1,44 @@
+import { DEFAULT_DB_POOL_MAX, HELLORUNTIME_ENV } from "@helloruntime/protocol";
+import { drizzle } from "drizzle-orm/node-postgres";
+import pg from "pg";
+// Drizzle over node-postgres on the injected POOLED endpoint. Small pool (the app
+// runs at maxScale=1 with bounded concurrency). Do NOT use `.prepare()` — the
+// pooled endpoint runs in transaction mode where persistent prepared statements
+// are unreliable.
+let instance = null;
+export function getDb() {
+    if (instance)
+        return instance;
+    const url = process.env[HELLORUNTIME_ENV.DATABASE_URL];
+    if (!url) {
+        throw new Error(`${HELLORUNTIME_ENV.DATABASE_URL} is not set — is this running inside a Helloruntime app?`);
+    }
+    const max = Number(process.env[HELLORUNTIME_ENV.DB_POOL_MAX] ?? DEFAULT_DB_POOL_MAX);
+    const pool = new pg.Pool({ connectionString: url, max: Number.isFinite(max) ? max : DEFAULT_DB_POOL_MAX });
+    instance = drizzle(pool);
+    return instance;
+}
+/** Lazily-initialized Drizzle handle. Use with your own schema: `db.select().from(table)`. */
+export const db = new Proxy({}, {
+    get(_target, property) {
+        return Reflect.get(getDb(), property);
+    }
+});
+/**
+ * Create a Drizzle database bound to your schema, over the injected pooled
+ * DATABASE_URL. The recommended entry point:
+ *
+ *   import { createDatabase } from "helloruntime";
+ *   import * as schema from "./schema";
+ *   export const db = createDatabase(schema);
+ */
+export function createDatabase(schema) {
+    const url = process.env[HELLORUNTIME_ENV.DATABASE_URL];
+    if (!url) {
+        throw new Error(`${HELLORUNTIME_ENV.DATABASE_URL} is not set — is this running inside a Helloruntime app?`);
+    }
+    const max = Number(process.env[HELLORUNTIME_ENV.DB_POOL_MAX] ?? DEFAULT_DB_POOL_MAX);
+    const pool = new pg.Pool({ connectionString: url, max: Number.isFinite(max) ? max : DEFAULT_DB_POOL_MAX });
+    return drizzle(pool, { schema });
+}
+//# sourceMappingURL=db.js.map

package/dist/sdk/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/sdk/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,kFAAkF;AAClF,8EAA8E;AAC9E,gFAAgF;AAChF,kBAAkB;AAClB,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAE3C,MAAM,UAAU,KAAK;IACnB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,GAAG,gBAAgB,CAAC,YAAY,0DAA0D,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC3G,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,EAAE,GAAmB,IAAI,KAAK,CAAC,EAAoB,EAAE;IAChE,GAAG,CAAC,OAAO,EAAE,QAAQ;QACnB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAY,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAe;IAEf,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,GAAG,gBAAgB,CAAC,YAAY,0DAA0D,CAAC,CAAC;IAC9G,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC3G,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,10 @@
+export { db, getDb, createDatabase } from "./db.js";
+export { defineJob, type JobDefinition } from "./jobs.js";
+export { defineCron, type CronDefinition } from "./cron.js";
+export { sendJob, type SendJobOptions, type SendJobResult } from "./send-job.js";
+export { createHelloruntimeHandler, type HelloruntimeHandlerOptions } from "./runtime/handler.js";
+export { helloruntimeExpress } from "./runtime/express.js";
+export { helloruntimeHono } from "./runtime/hono.js";
+export { registerHelloruntime } from "./runtime/register.js";
+export type { JobContext, CronContext, JobHandler, CronHandler } from "@helloruntime/protocol";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EAAE,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,11 @@
+// The public `helloruntime` SDK surface: import { db, defineCron, defineJob, sendJob } from "helloruntime".
+export { db, getDb, createDatabase } from "./db.js";
+export { defineJob } from "./jobs.js";
+export { defineCron } from "./cron.js";
+export { sendJob } from "./send-job.js";
+// Runtime: serve platform job/cron dispatch from inside the app's own HTTP server.
+export { createHelloruntimeHandler } from "./runtime/handler.js";
+export { helloruntimeExpress } from "./runtime/express.js";
+export { helloruntimeHono } from "./runtime/hono.js";
+export { registerHelloruntime } from "./runtime/register.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,SAAS,EAAsB,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAuB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAA2C,MAAM,eAAe,CAAC;AAEjF,mFAAmF;AACnF,OAAO,EAAE,yBAAyB,EAAmC,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/sdk/jobs.d.ts

@@ -0,0 +1,12 @@
+import { type JobHandler } from "@helloruntime/protocol";
+export interface JobDefinition<T = unknown> {
+    name: string;
+    handler: JobHandler<T>;
+}
+/**
+ * Register a job handler. The call is an import side-effect that fills the runtime
+ * registry; mount the SDK handler (helloruntimeExpress / helloruntimeHono / createHelloruntimeHandler)
+ * in your server to serve `_helloruntime/jobs/<name>`. Enqueue work with `sendJob(name, payload)`.
+ */
+export declare function defineJob<T = unknown>(name: string, handler: JobHandler<T>): JobDefinition<T>;
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/sdk/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAG7F"}

package/dist/sdk/jobs.js

@@ -0,0 +1,11 @@
+import { registerJob } from "@helloruntime/protocol";
+/**
+ * Register a job handler. The call is an import side-effect that fills the runtime
+ * registry; mount the SDK handler (helloruntimeExpress / helloruntimeHono / createHelloruntimeHandler)
+ * in your server to serve `_helloruntime/jobs/<name>`. Enqueue work with `sendJob(name, payload)`.
+ */
+export function defineJob(name, handler) {
+    registerJob(name, handler);
+    return { name, handler };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/sdk/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/sdk/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,wBAAwB,CAAC;AAOtE;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAc,IAAY,EAAE,OAAsB;IACzE,WAAW,CAAI,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/sdk/registry.d.ts

@@ -0,0 +1,2 @@
+export { getRegistry, snapshotRegistration, type RuntimeRegistry } from "@lakebed/protocol";
+//# sourceMappingURL=registry.d.ts.map

package/dist/sdk/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sdk/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sdk/registry.js

@@ -0,0 +1,5 @@
+// The `lakebed/_supervisor` subpath. The supervisor reads the populated registry
+// after importing the user entry. (The registry itself lives in @lakebed/protocol
+// so both the SDK and the supervisor depend only downward on protocol.)
+export { getRegistry, snapshotRegistration } from "@lakebed/protocol";
+//# sourceMappingURL=registry.js.map

package/dist/sdk/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/sdk/registry.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,wEAAwE;AACxE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAwB,MAAM,mBAAmB,CAAC"}

package/dist/sdk/runtime/express.d.ts

@@ -0,0 +1,6 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type HelloruntimeHandlerOptions } from "./handler.js";
+type NextFn = (err?: unknown) => void;
+export declare function helloruntimeExpress(options?: HelloruntimeHandlerOptions): (req: IncomingMessage, res: ServerResponse, next: NextFn) => void;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/sdk/runtime/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAA6B,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAK1F,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAKtC,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,IAInC,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,KAAG,IAAI,CAgBtG"}

package/dist/sdk/runtime/express.js

@@ -0,0 +1,56 @@
+import { createHelloruntimeHandler } from "./handler.js";
+import { registerHelloruntime } from "./register.js";
+const HELLORUNTIME_PREFIX = "/_helloruntime/";
+// Express middleware: terminates `/_helloruntime/*` dispatch (verifying HMAC + running
+// the registered job/cron) and calls next() for everything else. Mount it BEFORE
+// any body-parser — the HMAC covers the exact raw bytes, which a parser consumes.
+export function helloruntimeExpress(options = {}) {
+    const handle = createHelloruntimeHandler(options);
+    setImmediate(() => void registerHelloruntime()); // after the entry module's defineJob/defineCron run
+    return function helloruntimeMiddleware(req, res, next) {
+        if (!req.url?.startsWith(HELLORUNTIME_PREFIX)) {
+            next();
+            return;
+        }
+        readBody(req)
+            .then(async (body) => {
+            const response = await handle(toWebRequest(req, body));
+            if (!response) {
+                next();
+                return;
+            }
+            await writeResponse(res, response);
+        })
+            .catch((err) => next(err));
+    };
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(Buffer.from(c)));
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+function toWebRequest(req, body) {
+    const host = req.headers.host ?? "app.internal";
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (Array.isArray(value))
+            for (const v of value)
+                headers.append(key, v);
+        else if (value != null)
+            headers.set(key, value);
+    }
+    return new Request(`http://${host}${req.url}`, {
+        method: req.method ?? "GET",
+        headers,
+        body: body.length ? body : undefined
+    });
+}
+async function writeResponse(res, response) {
+    res.statusCode = response.status;
+    response.headers.forEach((value, key) => res.setHeader(key, value));
+    res.end(Buffer.from(await response.arrayBuffer()));
+}
+//# sourceMappingURL=express.js.map

package/dist/sdk/runtime/express.js.map

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

package/dist/sdk/runtime/handler.d.ts

@@ -0,0 +1,13 @@
+import { type RuntimeRegistry } from "@helloruntime/protocol";
+export interface HelloruntimeHandlerOptions {
+    /** The populated job/cron registry. Defaults to the global registry defineJob/defineCron fill. */
+    registry?: RuntimeRegistry;
+    /** Per-app HMAC secret; defaults to HELLORUNTIME_DISPATCH_SECRET. Verification fails closed if absent. */
+    dispatchSecret?: string;
+    /** Max time a handler may run (default 60 min, the safety ceiling). */
+    handlerTimeoutMs?: number;
+    /** Current unix seconds (injectable for tests). */
+    now?: () => number;
+}
+export declare function createHelloruntimeHandler(options?: HelloruntimeHandlerOptions): (request: Request) => Promise<Response | null>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/sdk/runtime/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,0BAA0B;IACzC,kGAAkG;IAClG,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,0GAA0G;IAC1G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AA0BD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA+DhD"}

package/dist/sdk/runtime/handler.js

@@ -0,0 +1,85 @@
+import { getRegistry, INTERNAL_CRON_PATH_PREFIX, INTERNAL_JOB_PATH_PREFIX, HELLORUNTIME_ENV } from "@helloruntime/protocol";
+import { verifyDispatchRequest } from "./verify.js";
+const DEFAULT_TIMEOUT_MS = 60 * 60 * 1000;
+function json(status, body) {
+    return new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" } });
+}
+async function runWithTimeout(fn, ms) {
+    let timer;
+    try {
+        await Promise.race([
+            Promise.resolve().then(fn),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`handler timed out after ${ms}ms`)), ms);
+            })
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+// The platform's job/cron dispatch handler, as a plain WHATWG fetch function.
+// Returns a Response for a verified `/_helloruntime/jobs|cron/:name` POST, or `null`
+// for any other request so the host app serves its own routes. This is what the
+// Express/Hono shims wrap; raw `node:http` servers can call it directly.
+export function createHelloruntimeHandler(options = {}) {
+    const registry = options.registry ?? getRegistry();
+    const timeoutMs = options.handlerTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const now = options.now ?? (() => Math.floor(Date.now() / 1000));
+    return async function handleDispatch(request) {
+        const path = new URL(request.url).pathname;
+        const isJob = path.startsWith(INTERNAL_JOB_PATH_PREFIX);
+        const isCron = path.startsWith(INTERNAL_CRON_PATH_PREFIX);
+        if (!isJob && !isCron)
+            return null; // not ours → host app handles it
+        if (request.method !== "POST")
+            return json(405, { error: "method not allowed" });
+        const secret = options.dispatchSecret ?? process.env[HELLORUNTIME_ENV.DISPATCH_SECRET];
+        const rawBody = await request.text();
+        const verified = verifyDispatchRequest({
+            method: "POST",
+            path,
+            headers: request.headers,
+            rawBody,
+            secret,
+            nowSeconds: now()
+        });
+        if (!verified.ok)
+            return json(verified.status, { error: verified.reason });
+        const { envelope } = verified;
+        if (envelope.kind !== (isJob ? "job" : "cron"))
+            return json(400, { error: "kind mismatch" });
+        const prefix = isJob ? INTERNAL_JOB_PATH_PREFIX : INTERNAL_CRON_PATH_PREFIX;
+        const name = decodeURIComponent(path.slice(prefix.length));
+        try {
+            if (isJob) {
+                const handler = registry.jobs.get(name);
+                if (!handler)
+                    return json(404, { error: `No job registered named "${name}"` });
+                await runWithTimeout(() => handler(envelope.payload, {
+                    name,
+                    jobId: envelope.jobId,
+                    idempotencyKey: envelope.idempotencyKey,
+                    attempt: envelope.attempt
+                }), timeoutMs);
+            }
+            else {
+                const entry = registry.crons.get(name);
+                if (!entry)
+                    return json(404, { error: `No cron registered named "${name}"` });
+                await runWithTimeout(() => entry.handler({
+                    name,
+                    schedule: entry.schedule,
+                    idempotencyKey: envelope.idempotencyKey,
+                    scheduledAt: new Date(envelope.enqueuedAt)
+                }), timeoutMs);
+            }
+            return json(200, { ok: true });
+        }
+        catch (error) {
+            return json(500, { error: error instanceof Error ? error.message : String(error) });
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/sdk/runtime/handler.js.map

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

package/dist/sdk/runtime/hono.d.ts

@@ -0,0 +1,10 @@
+import { type HelloruntimeHandlerOptions } from "./handler.js";
+interface HonoContextLike {
+    req: {
+        raw: Request;
+    };
+}
+type HonoNext = () => Promise<void>;
+export declare function helloruntimeHono(options?: HelloruntimeHandlerOptions): (c: HonoContextLike, next: HonoNext) => Promise<Response | void>;
+export {};
+//# sourceMappingURL=hono.d.ts.map

package/dist/sdk/runtime/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAK1F,UAAU,eAAe;IACvB,GAAG,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;CACvB;AACD,KAAK,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAKpC,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,0BAA+B,IAI1B,GAAG,eAAe,EAAE,MAAM,QAAQ,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAK3G"}

package/dist/sdk/runtime/hono.js

@@ -0,0 +1,16 @@
+import { createHelloruntimeHandler } from "./handler.js";
+import { registerHelloruntime } from "./register.js";
+// Hono middleware: terminates `/_helloruntime/*` dispatch, falls through otherwise.
+// `app.use(helloruntimeHono())`. The handler inspects the path before touching the body,
+// so non-dispatch requests pass through with their body intact.
+export function helloruntimeHono(options = {}) {
+    const handle = createHelloruntimeHandler(options);
+    setImmediate(() => void registerHelloruntime());
+    return async function helloruntimeMiddleware(c, next) {
+        const response = await handle(c.req.raw);
+        if (response)
+            return response;
+        await next();
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/sdk/runtime/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../../src/sdk/runtime/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAmC,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AASrD,oFAAoF;AACpF,yFAAyF;AACzF,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,UAAsC,EAAE;IACvE,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAClD,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,oBAAoB,EAAE,CAAC,CAAC;IAEhD,OAAO,KAAK,UAAU,sBAAsB,CAAC,CAAkB,EAAE,IAAc;QAC7E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/sdk/runtime/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * POST the app's full job/cron snapshot to the control plane (runtime token auth).
+ * The platform treats it as desired-state and reconciles cron schedules. Fires at
+ * most once per process; best-effort — never wedges boot. The framework shims call
+ * this automatically; raw servers (or other languages) can call it themselves (or
+ * POST the same JSON to RUNTIME_REGISTER_PATH).
+ */
+export declare function registerHelloruntime(): Promise<void>;
+//# sourceMappingURL=register.d.ts.map

package/dist/sdk/runtime/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/register.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB1D"}

package/dist/sdk/runtime/register.js

@@ -0,0 +1,32 @@
+import { HELLORUNTIME_ENV, RUNTIME_REGISTER_PATH, snapshotRegistration } from "@helloruntime/protocol";
+let registered = false;
+/**
+ * POST the app's full job/cron snapshot to the control plane (runtime token auth).
+ * The platform treats it as desired-state and reconciles cron schedules. Fires at
+ * most once per process; best-effort — never wedges boot. The framework shims call
+ * this automatically; raw servers (or other languages) can call it themselves (or
+ * POST the same JSON to RUNTIME_REGISTER_PATH).
+ */
+export async function registerHelloruntime() {
+    if (registered)
+        return;
+    registered = true;
+    const apiUrl = process.env[HELLORUNTIME_ENV.API_URL];
+    const token = process.env[HELLORUNTIME_ENV.TOKEN];
+    if (!apiUrl || !token)
+        return;
+    try {
+        const response = await fetch(new URL(RUNTIME_REGISTER_PATH, apiUrl), {
+            method: "POST",
+            headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+            body: JSON.stringify(snapshotRegistration())
+        });
+        if (!response.ok) {
+            console.warn(`helloruntime: self-register returned ${response.status} (continuing)`);
+        }
+    }
+    catch (error) {
+        console.warn("helloruntime: self-register failed (continuing):", error);
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/sdk/runtime/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/sdk/runtime/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEvG,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;QAAE,OAAO;IAE9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;YACjF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;SAC7C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,wCAAwC,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/sdk/runtime/verify.d.ts

@@ -0,0 +1,20 @@
+import { type DispatchEnvelope } from "@helloruntime/protocol";
+export interface IncomingDispatch {
+    method: string;
+    path: string;
+    headers: Headers;
+    rawBody: string;
+    /** HELLORUNTIME_DISPATCH_SECRET injected into the app. */
+    secret: string | undefined;
+    nowSeconds: number;
+}
+export type DispatchVerification = {
+    ok: true;
+    envelope: DispatchEnvelope;
+} | {
+    ok: false;
+    status: 400 | 401;
+    reason: string;
+};
+export declare function verifyDispatchRequest(req: IncomingDispatch): DispatchVerification;
+//# sourceMappingURL=verify.d.ts.map

package/dist/sdk/runtime/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAOhC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,oBAAoB,CA4BjF"}

package/dist/sdk/runtime/verify.js

@@ -0,0 +1,29 @@
+import { dispatchEnvelopeSchema, DISPATCH_HEADERS, verifyDispatch } from "@helloruntime/protocol";
+export function verifyDispatchRequest(req) {
+    // Parse + validate the envelope first; the idempotencyKey it carries is what the
+    // signature was computed over.
+    let envelope;
+    try {
+        envelope = dispatchEnvelopeSchema.parse(JSON.parse(req.rawBody));
+    }
+    catch {
+        return { ok: false, status: 400, reason: "invalid-envelope" };
+    }
+    const result = verifyDispatch({
+        secret: req.secret,
+        method: req.method,
+        path: req.path,
+        rawBody: req.rawBody,
+        signatureHeader: req.headers.get(DISPATCH_HEADERS.signature),
+        timestampHeader: req.headers.get(DISPATCH_HEADERS.timestamp),
+        idempotencyKey: envelope.idempotencyKey,
+        nowSeconds: req.nowSeconds
+    });
+    if (!result.ok) {
+        // All verification failures (incl. fail-closed missing-secret) reject as 401.
+        // The dispatcher maps 401/403 to dead-letter + alert.
+        return { ok: false, status: 401, reason: result.reason };
+    }
+    return { ok: true, envelope };
+}
+//# sourceMappingURL=verify.js.map

package/dist/sdk/runtime/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/sdk/runtime/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAqBhC,MAAM,UAAU,qBAAqB,CAAC,GAAqB;IACzD,iFAAiF;IACjF,+BAA+B;IAC/B,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;QAC5D,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;QAC5D,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,8EAA8E;QAC9E,sDAAsD;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/sdk/send-job.d.ts

@@ -0,0 +1,15 @@
+export interface SendJobOptions {
+    /** Producer-side dedupe key: identical keys enqueue the job at most once. */
+    dedupeKey?: string;
+    /** Earliest time the job may be dispatched. */
+    notBefore?: Date;
+}
+export interface SendJobResult {
+    jobId: string;
+}
+/**
+ * Enqueue a job with the durable platform dispatcher. The app is inferred from
+ * the injected runtime token (HELLORUNTIME_TOKEN) — never from the URL.
+ */
+export declare function sendJob(name: string, payload: unknown, options?: SendJobOptions): Promise<SendJobResult>;
+//# sourceMappingURL=send-job.d.ts.map

package/dist/sdk/send-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-job.d.ts","sourceRoot":"","sources":["../../src/sdk/send-job.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA+BxB"}

package/dist/sdk/send-job.js

@@ -0,0 +1,36 @@
+import { HELLORUNTIME_ENV, SENDJOB_DEDUPE_HEADER, SENDJOB_PATH } from "@helloruntime/protocol";
+/**
+ * Enqueue a job with the durable platform dispatcher. The app is inferred from
+ * the injected runtime token (HELLORUNTIME_TOKEN) — never from the URL.
+ */
+export async function sendJob(name, payload, options = {}) {
+    const apiUrl = process.env[HELLORUNTIME_ENV.API_URL];
+    const token = process.env[HELLORUNTIME_ENV.TOKEN];
+    if (!apiUrl)
+        throw new Error(`${HELLORUNTIME_ENV.API_URL} is not set`);
+    if (!token)
+        throw new Error(`${HELLORUNTIME_ENV.TOKEN} is not set`);
+    const body = {
+        name,
+        payload,
+        dedupeKey: options.dedupeKey,
+        notBefore: options.notBefore?.toISOString()
+    };
+    const headers = {
+        "content-type": "application/json",
+        authorization: `Bearer ${token}`
+    };
+    if (options.dedupeKey)
+        headers[SENDJOB_DEDUPE_HEADER] = options.dedupeKey;
+    const response = await fetch(new URL(SENDJOB_PATH, apiUrl), {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw new Error(`sendJob failed: ${response.status} ${detail}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=send-job.js.map

package/dist/sdk/send-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-job.js","sourceRoot":"","sources":["../../src/sdk/send-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,YAAY,EAAuB,MAAM,wBAAwB,CAAC;AAapH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAY,EACZ,OAAgB,EAChB,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,gBAAgB,CAAC,OAAO,aAAa,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,aAAa,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAmB;QAC3B,IAAI;QACJ,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE;KAC5C,CAAC;IAEF,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,aAAa,EAAE,UAAU,KAAK,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,SAAS;QAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAE1E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE;QAC1D,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;AAClD,CAAC"}

package/helloruntime.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://helloruntime.dev/schema/helloruntime.json",
+  "title": "Helloruntime app config",
+  "description": "Build + deploy knobs for a Helloruntime app (helloruntime.json). All fields are optional. Helloruntime builds the Dockerfile your source ships (./Dockerfile, or build.dockerfile).",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for editor autocomplete/validation."
+    },
+    "build": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "How the source becomes an image.",
+      "properties": {
+        "dockerfile": {
+          "type": "string",
+          "description": "Path to the Dockerfile to build, relative to the project root. Defaults to ./Dockerfile (required)."
+        }
+      }
+    },
+    "deploy": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Deploy-time behavior.",
+      "properties": {
+        "release": {
+          "type": "string",
+          "description": "One-shot command run in the built image before cutover (e.g. database migrations). The deploy fails if it exits non-zero."
+        }
+      }
+    },
+    "database": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Managed database.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Provision a managed Postgres and inject DATABASE_URL. Set false to opt out."
+        }
+      }
+    }
+  }
+}