@roko-app/instant-admin 1.0.67-roko.1 → 1.0.67-roko.3

package/dist/esm/alarms.d.ts

@@ -0,0 +1,138 @@
+/** Where an alarm is in its life. */
+export type AlarmStatus = 
+/** Waits for its time. */
+'pending'
+/** Being delivered right now. */
+ | 'processing'
+/** A delivery failed; it will be retried. */
+ | 'error'
+/** Delivered. */
+ | 'fired'
+/** Gave up after the last retry, or the endpoint answered 410 Gone. */
+ | 'failed';
+/** The last delivery attempt of an alarm. */
+export type AlarmAttempt = {
+    /** When the attempt was made (ISO 8601). */
+    at: string | null;
+    /** True if the endpoint answered with a 2xx status. */
+    success: boolean;
+    /** HTTP status of the answer, if there was one. */
+    statusCode: number | null;
+    /** Kind of failure when there was no answer, e.g. `timeout` or `dns`. */
+    errorType: string | null;
+    errorMessage: string | null;
+};
+/** An alarm as the server stores it. */
+export type AlarmInfo = {
+    /** Changes every time the key is set again; also the `Idempotency-Key` of its deliveries. */
+    id: string;
+    /** Your name for the alarm, unique per app. */
+    key: string;
+    /** When it fires (ISO 8601). */
+    fireAt: string;
+    /** The https url that is called. */
+    url: string;
+    /** Sent back to you, unchanged, when the alarm fires. */
+    payload: Record<string, unknown> | null;
+    status: AlarmStatus;
+    /** How many deliveries were attempted. */
+    attempts: number;
+    lastAttempt: AlarmAttempt | null;
+    /** When the next retry happens, while `status` is `error`. */
+    nextAttemptAfter: string | null;
+    firedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** The body POSTed to the alarm's url when it fires. */
+export type AlarmEvent = {
+    type: 'alarm';
+    id: string;
+    appId: string;
+    key: string;
+    /** The time the alarm was set for (ISO 8601). */
+    fireAt: string;
+    /** 1 for the first delivery, 2 for the first retry, and so on. */
+    attempt: number;
+    payload: Record<string, unknown> | null;
+};
+export type SetAlarmParams = {
+    /** Your name for the alarm. Setting the same key again replaces the alarm. */
+    key: string;
+    /** When to fire: a Date, milliseconds since the epoch, or an ISO 8601 string. A time in the past fires at once. */
+    fireAt: Date | number | string;
+    /** A public https url. It receives a POST signed with `Instant-Signature`. */
+    url: string;
+    /** A JSON object (64 KB at most) sent back to you when the alarm fires. */
+    payload?: Record<string, unknown> | null;
+};
+export type ListAlarmsParams = {
+    /** Keep one status only. */
+    status?: AlarmStatus;
+    /** Page size, 100 by default, 1000 at most. */
+    limit?: number;
+    /** Continue after this `fireAt` (the last alarm of the previous page). */
+    after?: Date | number | string;
+};
+export type AlarmValidateOpts = {
+    receivedAt?: Date | null;
+    /** Oldest signature accepted, in seconds. Default 300. */
+    tolerance?: number | null;
+};
+type AlarmsDeps = {
+    apiURI: string;
+    appId: string;
+    /** Builds the authorized request headers; throws without an admin token. */
+    headers: () => Record<string, string>;
+    jsonFetch: (input: string, init?: RequestInit) => Promise<unknown>;
+    /** Checks an `Instant-Signature` header and returns the verified body text. */
+    verifySignature: (signatureHeader: string, body: string | (() => Promise<string>), opts?: AlarmValidateOpts | null) => Promise<string>;
+};
+/** Reads a verified alarm body. Throws if it is not an alarm. */
+export declare function parseAlarmEvent(bodyText: string): AlarmEvent;
+/** Turns a Date / epoch milliseconds / ISO string into what the server takes. */
+export declare function toAlarmTime(time: Date | number | string): number | string;
+/**
+ * Alarms: ask the server to call your url at a given time.
+ *
+ * @example
+ *  // When work starts, ask to be called if it is not done in one hour.
+ *  await db.alarms.set({
+ *    key: `effort:${taskId}`,
+ *    fireAt: Date.now() + 60 * 60 * 1000,
+ *    url: 'https://example.com/api/alarms',
+ *    payload: { taskId },
+ *  });
+ *
+ *  // In the route behind that url.
+ *  export async function POST(req: Request) {
+ *    const alarm = await db.alarms.validateRequest(req);
+ *    await pauseTask(alarm.payload);
+ *    return new Response('ok');
+ *  }
+ */
+export declare class Alarms {
+    #private;
+    constructor(deps: AlarmsDeps);
+    /**
+     * Creates the alarm for `key`, or replaces the one that exists. A replaced
+     * alarm starts over with a new id, even if it had already fired.
+     */
+    set: (params: SetAlarmParams) => Promise<AlarmInfo>;
+    /** Returns the alarm for `key`, or null if there is none. */
+    get: (key: string) => Promise<AlarmInfo | null>;
+    /** Lists the app's alarms, soonest first. */
+    list: (params?: ListAlarmsParams) => Promise<AlarmInfo[]>;
+    /** Deletes the alarm for `key`. Returns false if there was none. */
+    delete: (key: string) => Promise<boolean>;
+    /**
+     * Verifies the `Instant-Signature` header of an alarm delivery against its
+     * raw body and returns the alarm. Throws if the signature is wrong or too
+     * old, if the body is not an alarm, or if the alarm belongs to another app.
+     */
+    validate: (signatureHeader: string, body: string | (() => Promise<string>), opts?: AlarmValidateOpts | null) => Promise<AlarmEvent>;
+    /** Same as {@link validate}, reading the header and body from a `Request`. */
+    validateRequest: (req: Request, opts?: AlarmValidateOpts | null) => Promise<AlarmEvent>;
+}
+export {};
+//# sourceMappingURL=alarms.d.ts.map

package/dist/esm/alarms.d.ts.map

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

package/dist/esm/alarms.js

@@ -0,0 +1,202 @@
+// Roko DB: alarms. An alarm asks the server to POST a signed JSON body to a
+// url at a given time. One alarm per key; setting a key again replaces it.
+// #endregion
+// #region Parsing
+const ALARM_STATUSES = [
+    'pending',
+    'processing',
+    'error',
+    'fired',
+    'failed',
+];
+function isRecord(x) {
+    return typeof x === 'object' && x !== null && !Array.isArray(x);
+}
+function isAlarmStatus(x) {
+    return ALARM_STATUSES.some((status) => status === x);
+}
+function stringOrNull(x) {
+    return typeof x === 'string' ? x : null;
+}
+function numberOrNull(x) {
+    return typeof x === 'number' ? x : null;
+}
+function requiredString(source, field) {
+    const value = source[field];
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid alarm: expected a string in \`${field}\`.`);
+    }
+    return value;
+}
+function parseAttempt(x) {
+    if (!isRecord(x)) {
+        return null;
+    }
+    return {
+        at: stringOrNull(x.at),
+        success: x.success === true,
+        statusCode: numberOrNull(x.statusCode),
+        errorType: stringOrNull(x.errorType),
+        errorMessage: stringOrNull(x.errorMessage),
+    };
+}
+function parseAlarm(x) {
+    if (!isRecord(x)) {
+        throw new Error('Invalid alarm: expected an object.');
+    }
+    if (!isAlarmStatus(x.status)) {
+        throw new Error('Invalid alarm: unknown status.');
+    }
+    return {
+        id: requiredString(x, 'id'),
+        key: requiredString(x, 'key'),
+        fireAt: requiredString(x, 'fireAt'),
+        url: requiredString(x, 'url'),
+        payload: isRecord(x.payload) ? x.payload : null,
+        status: x.status,
+        attempts: numberOrNull(x.attempts) ?? 0,
+        lastAttempt: parseAttempt(x.lastAttempt),
+        nextAttemptAfter: stringOrNull(x.nextAttemptAfter),
+        firedAt: stringOrNull(x.firedAt),
+        createdAt: requiredString(x, 'createdAt'),
+        updatedAt: requiredString(x, 'updatedAt'),
+    };
+}
+/** Reads a verified alarm body. Throws if it is not an alarm. */
+export function parseAlarmEvent(bodyText) {
+    const body = JSON.parse(bodyText);
+    if (!isRecord(body) || body.type !== 'alarm') {
+        throw new Error('Invalid alarm body, expected an object with type "alarm".');
+    }
+    return {
+        type: 'alarm',
+        id: requiredString(body, 'id'),
+        appId: requiredString(body, 'appId'),
+        key: requiredString(body, 'key'),
+        fireAt: requiredString(body, 'fireAt'),
+        attempt: numberOrNull(body.attempt) ?? 1,
+        payload: isRecord(body.payload) ? body.payload : null,
+    };
+}
+/** Turns a Date / epoch milliseconds / ISO string into what the server takes. */
+export function toAlarmTime(time) {
+    if (time instanceof Date) {
+        const ms = time.getTime();
+        if (Number.isNaN(ms)) {
+            throw new Error('Invalid alarm time: the Date is not valid.');
+        }
+        return ms;
+    }
+    return time;
+}
+// #endregion
+// #region Alarms
+/**
+ * Alarms: ask the server to call your url at a given time.
+ *
+ * @example
+ *  // When work starts, ask to be called if it is not done in one hour.
+ *  await db.alarms.set({
+ *    key: `effort:${taskId}`,
+ *    fireAt: Date.now() + 60 * 60 * 1000,
+ *    url: 'https://example.com/api/alarms',
+ *    payload: { taskId },
+ *  });
+ *
+ *  // In the route behind that url.
+ *  export async function POST(req: Request) {
+ *    const alarm = await db.alarms.validateRequest(req);
+ *    await pauseTask(alarm.payload);
+ *    return new Response('ok');
+ *  }
+ */
+export class Alarms {
+    #deps;
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    #url(query) {
+        const qs = new URLSearchParams({ app_id: this.#deps.appId, ...query });
+        return `${this.#deps.apiURI}/admin/alarms?${qs.toString()}`;
+    }
+    /**
+     * Creates the alarm for `key`, or replaces the one that exists. A replaced
+     * alarm starts over with a new id, even if it had already fired.
+     */
+    set = async (params) => {
+        const res = await this.#deps.jsonFetch(this.#url(), {
+            method: 'PUT',
+            headers: this.#deps.headers(),
+            body: JSON.stringify({
+                key: params.key,
+                fireAt: toAlarmTime(params.fireAt),
+                url: params.url,
+                payload: params.payload ?? null,
+            }),
+        });
+        return parseAlarm(isRecord(res) ? res.alarm : null);
+    };
+    /** Returns the alarm for `key`, or null if there is none. */
+    get = async (key) => {
+        const res = await this.#deps.jsonFetch(this.#url({ key }), {
+            method: 'GET',
+            headers: this.#deps.headers(),
+        });
+        const alarm = isRecord(res) ? res.alarm : null;
+        return alarm == null ? null : parseAlarm(alarm);
+    };
+    /** Lists the app's alarms, soonest first. */
+    list = async (params = {}) => {
+        const query = {};
+        if (params.status) {
+            query.status = params.status;
+        }
+        if (params.limit !== undefined) {
+            query.limit = String(params.limit);
+        }
+        if (params.after !== undefined) {
+            const after = toAlarmTime(params.after);
+            query.after =
+                typeof after === 'number' ? new Date(after).toISOString() : after;
+        }
+        const res = await this.#deps.jsonFetch(this.#url(query), {
+            method: 'GET',
+            headers: this.#deps.headers(),
+        });
+        const alarms = isRecord(res) ? res.alarms : null;
+        return Array.isArray(alarms) ? alarms.map(parseAlarm) : [];
+    };
+    /** Deletes the alarm for `key`. Returns false if there was none. */
+    delete = async (key) => {
+        const res = await this.#deps.jsonFetch(this.#url({ key }), {
+            method: 'DELETE',
+            headers: this.#deps.headers(),
+        });
+        return isRecord(res) && res.deleted === true;
+    };
+    /**
+     * Verifies the `Instant-Signature` header of an alarm delivery against its
+     * raw body and returns the alarm. Throws if the signature is wrong or too
+     * old, if the body is not an alarm, or if the alarm belongs to another app.
+     */
+    validate = async (signatureHeader, body, opts) => {
+        const bodyText = await this.#deps.verifySignature(signatureHeader, body, opts);
+        const event = parseAlarmEvent(bodyText);
+        // The signing key is the server's, shared by every app on it: without
+        // this check another app could aim its own alarm at this endpoint.
+        if (event.appId !== this.#deps.appId) {
+            throw new Error('Alarm belongs to another app');
+        }
+        return event;
+    };
+    /** Same as {@link validate}, reading the header and body from a `Request`. */
+    validateRequest = async (req, opts) => {
+        const signatureHeader = req.headers.get('instant-signature');
+        if (!signatureHeader) {
+            throw new Error('Request is missing Instant-Signature header');
+        }
+        return this.validate(signatureHeader, () => req.text(), opts);
+    };
+}
+// #endregion
+//# sourceMappingURL=alarms.js.map

package/dist/esm/alarms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarms.js","sourceRoot":"","sources":["../../src/alarms.ts"],"names":[],"mappings":"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","sourcesContent":["// Roko DB: alarms. An alarm asks the server to POST a signed JSON body to a\n// url at a given time. One alarm per key; setting a key again replaces it.\n\n// #region Types\n\n/** Where an alarm is in its life. */\nexport type AlarmStatus =\n  /** Waits for its time. */\n  | 'pending'\n  /** Being delivered right now. */\n  | 'processing'\n  /** A delivery failed; it will be retried. */\n  | 'error'\n  /** Delivered. */\n  | 'fired'\n  /** Gave up after the last retry, or the endpoint answered 410 Gone. */\n  | 'failed';\n\n/** The last delivery attempt of an alarm. */\nexport type AlarmAttempt = {\n  /** When the attempt was made (ISO 8601). */\n  at: string | null;\n  /** True if the endpoint answered with a 2xx status. */\n  success: boolean;\n  /** HTTP status of the answer, if there was one. */\n  statusCode: number | null;\n  /** Kind of failure when there was no answer, e.g. `timeout` or `dns`. */\n  errorType: string | null;\n  errorMessage: string | null;\n};\n\n/** An alarm as the server stores it. */\nexport type AlarmInfo = {\n  /** Changes every time the key is set again; also the `Idempotency-Key` of its deliveries. */\n  id: string;\n  /** Your name for the alarm, unique per app. */\n  key: string;\n  /** When it fires (ISO 8601). */\n  fireAt: string;\n  /** The https url that is called. */\n  url: string;\n  /** Sent back to you, unchanged, when the alarm fires. */\n  payload: Record<string, unknown> | null;\n  status: AlarmStatus;\n  /** How many deliveries were attempted. */\n  attempts: number;\n  lastAttempt: AlarmAttempt | null;\n  /** When the next retry happens, while `status` is `error`. */\n  nextAttemptAfter: string | null;\n  firedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/** The body POSTed to the alarm's url when it fires. */\nexport type AlarmEvent = {\n  type: 'alarm';\n  id: string;\n  appId: string;\n  key: string;\n  /** The time the alarm was set for (ISO 8601). */\n  fireAt: string;\n  /** 1 for the first delivery, 2 for the first retry, and so on. */\n  attempt: number;\n  payload: Record<string, unknown> | null;\n};\n\nexport type SetAlarmParams = {\n  /** Your name for the alarm. Setting the same key again replaces the alarm. */\n  key: string;\n  /** When to fire: a Date, milliseconds since the epoch, or an ISO 8601 string. A time in the past fires at once. */\n  fireAt: Date | number | string;\n  /** A public https url. It receives a POST signed with `Instant-Signature`. */\n  url: string;\n  /** A JSON object (64 KB at most) sent back to you when the alarm fires. */\n  payload?: Record<string, unknown> | null;\n};\n\nexport type ListAlarmsParams = {\n  /** Keep one status only. */\n  status?: AlarmStatus;\n  /** Page size, 100 by default, 1000 at most. */\n  limit?: number;\n  /** Continue after this `fireAt` (the last alarm of the previous page). */\n  after?: Date | number | string;\n};\n\nexport type AlarmValidateOpts = {\n  receivedAt?: Date | null;\n  /** Oldest signature accepted, in seconds. Default 300. */\n  tolerance?: number | null;\n};\n\ntype AlarmsDeps = {\n  apiURI: string;\n  appId: string;\n  /** Builds the authorized request headers; throws without an admin token. */\n  headers: () => Record<string, string>;\n  jsonFetch: (input: string, init?: RequestInit) => Promise<unknown>;\n  /** Checks an `Instant-Signature` header and returns the verified body text. */\n  verifySignature: (\n    signatureHeader: string,\n    body: string | (() => Promise<string>),\n    opts?: AlarmValidateOpts | null,\n  ) => Promise<string>;\n};\n\n// #endregion\n\n// #region Parsing\n\nconst ALARM_STATUSES: readonly AlarmStatus[] = [\n  'pending',\n  'processing',\n  'error',\n  'fired',\n  'failed',\n];\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction isAlarmStatus(x: unknown): x is AlarmStatus {\n  return ALARM_STATUSES.some((status) => status === x);\n}\n\nfunction stringOrNull(x: unknown): string | null {\n  return typeof x === 'string' ? x : null;\n}\n\nfunction numberOrNull(x: unknown): number | null {\n  return typeof x === 'number' ? x : null;\n}\n\nfunction requiredString(source: Record<string, unknown>, field: string) {\n  const value = source[field];\n  if (typeof value !== 'string') {\n    throw new Error(`Invalid alarm: expected a string in \\`${field}\\`.`);\n  }\n  return value;\n}\n\nfunction parseAttempt(x: unknown): AlarmAttempt | null {\n  if (!isRecord(x)) {\n    return null;\n  }\n  return {\n    at: stringOrNull(x.at),\n    success: x.success === true,\n    statusCode: numberOrNull(x.statusCode),\n    errorType: stringOrNull(x.errorType),\n    errorMessage: stringOrNull(x.errorMessage),\n  };\n}\n\nfunction parseAlarm(x: unknown): AlarmInfo {\n  if (!isRecord(x)) {\n    throw new Error('Invalid alarm: expected an object.');\n  }\n  if (!isAlarmStatus(x.status)) {\n    throw new Error('Invalid alarm: unknown status.');\n  }\n  return {\n    id: requiredString(x, 'id'),\n    key: requiredString(x, 'key'),\n    fireAt: requiredString(x, 'fireAt'),\n    url: requiredString(x, 'url'),\n    payload: isRecord(x.payload) ? x.payload : null,\n    status: x.status,\n    attempts: numberOrNull(x.attempts) ?? 0,\n    lastAttempt: parseAttempt(x.lastAttempt),\n    nextAttemptAfter: stringOrNull(x.nextAttemptAfter),\n    firedAt: stringOrNull(x.firedAt),\n    createdAt: requiredString(x, 'createdAt'),\n    updatedAt: requiredString(x, 'updatedAt'),\n  };\n}\n\n/** Reads a verified alarm body. Throws if it is not an alarm. */\nexport function parseAlarmEvent(bodyText: string): AlarmEvent {\n  const body: unknown = JSON.parse(bodyText);\n  if (!isRecord(body) || body.type !== 'alarm') {\n    throw new Error(\n      'Invalid alarm body, expected an object with type \"alarm\".',\n    );\n  }\n  return {\n    type: 'alarm',\n    id: requiredString(body, 'id'),\n    appId: requiredString(body, 'appId'),\n    key: requiredString(body, 'key'),\n    fireAt: requiredString(body, 'fireAt'),\n    attempt: numberOrNull(body.attempt) ?? 1,\n    payload: isRecord(body.payload) ? body.payload : null,\n  };\n}\n\n/** Turns a Date / epoch milliseconds / ISO string into what the server takes. */\nexport function toAlarmTime(time: Date | number | string): number | string {\n  if (time instanceof Date) {\n    const ms = time.getTime();\n    if (Number.isNaN(ms)) {\n      throw new Error('Invalid alarm time: the Date is not valid.');\n    }\n    return ms;\n  }\n  return time;\n}\n\n// #endregion\n\n// #region Alarms\n\n/**\n * Alarms: ask the server to call your url at a given time.\n *\n * @example\n *  // When work starts, ask to be called if it is not done in one hour.\n *  await db.alarms.set({\n *    key: `effort:${taskId}`,\n *    fireAt: Date.now() + 60 * 60 * 1000,\n *    url: 'https://example.com/api/alarms',\n *    payload: { taskId },\n *  });\n *\n *  // In the route behind that url.\n *  export async function POST(req: Request) {\n *    const alarm = await db.alarms.validateRequest(req);\n *    await pauseTask(alarm.payload);\n *    return new Response('ok');\n *  }\n */\nexport class Alarms {\n  #deps: AlarmsDeps;\n\n  constructor(deps: AlarmsDeps) {\n    this.#deps = deps;\n  }\n\n  #url(query?: Record<string, string>): string {\n    const qs = new URLSearchParams({ app_id: this.#deps.appId, ...query });\n    return `${this.#deps.apiURI}/admin/alarms?${qs.toString()}`;\n  }\n\n  /**\n   * Creates the alarm for `key`, or replaces the one that exists. A replaced\n   * alarm starts over with a new id, even if it had already fired.\n   */\n  set = async (params: SetAlarmParams): Promise<AlarmInfo> => {\n    const res = await this.#deps.jsonFetch(this.#url(), {\n      method: 'PUT',\n      headers: this.#deps.headers(),\n      body: JSON.stringify({\n        key: params.key,\n        fireAt: toAlarmTime(params.fireAt),\n        url: params.url,\n        payload: params.payload ?? null,\n      }),\n    });\n    return parseAlarm(isRecord(res) ? res.alarm : null);\n  };\n\n  /** Returns the alarm for `key`, or null if there is none. */\n  get = async (key: string): Promise<AlarmInfo | null> => {\n    const res = await this.#deps.jsonFetch(this.#url({ key }), {\n      method: 'GET',\n      headers: this.#deps.headers(),\n    });\n    const alarm = isRecord(res) ? res.alarm : null;\n    return alarm == null ? null : parseAlarm(alarm);\n  };\n\n  /** Lists the app's alarms, soonest first. */\n  list = async (params: ListAlarmsParams = {}): Promise<AlarmInfo[]> => {\n    const query: Record<string, string> = {};\n    if (params.status) {\n      query.status = params.status;\n    }\n    if (params.limit !== undefined) {\n      query.limit = String(params.limit);\n    }\n    if (params.after !== undefined) {\n      const after = toAlarmTime(params.after);\n      query.after =\n        typeof after === 'number' ? new Date(after).toISOString() : after;\n    }\n    const res = await this.#deps.jsonFetch(this.#url(query), {\n      method: 'GET',\n      headers: this.#deps.headers(),\n    });\n    const alarms = isRecord(res) ? res.alarms : null;\n    return Array.isArray(alarms) ? alarms.map(parseAlarm) : [];\n  };\n\n  /** Deletes the alarm for `key`. Returns false if there was none. */\n  delete = async (key: string): Promise<boolean> => {\n    const res = await this.#deps.jsonFetch(this.#url({ key }), {\n      method: 'DELETE',\n      headers: this.#deps.headers(),\n    });\n    return isRecord(res) && res.deleted === true;\n  };\n\n  /**\n   * Verifies the `Instant-Signature` header of an alarm delivery against its\n   * raw body and returns the alarm. Throws if the signature is wrong or too\n   * old, if the body is not an alarm, or if the alarm belongs to another app.\n   */\n  validate = async (\n    signatureHeader: string,\n    body: string | (() => Promise<string>),\n    opts?: AlarmValidateOpts | null,\n  ): Promise<AlarmEvent> => {\n    const bodyText = await this.#deps.verifySignature(\n      signatureHeader,\n      body,\n      opts,\n    );\n    const event = parseAlarmEvent(bodyText);\n    // The signing key is the server's, shared by every app on it: without\n    // this check another app could aim its own alarm at this endpoint.\n    if (event.appId !== this.#deps.appId) {\n      throw new Error('Alarm belongs to another app');\n    }\n    return event;\n  };\n\n  /** Same as {@link validate}, reading the header and body from a `Request`. */\n  validateRequest = async (\n    req: Request,\n    opts?: AlarmValidateOpts | null,\n  ): Promise<AlarmEvent> => {\n    const signatureHeader = req.headers.get('instant-signature');\n    if (!signatureHeader) {\n      throw new Error('Request is missing Instant-Signature header');\n    }\n    return this.validate(signatureHeader, () => req.text(), opts);\n  };\n}\n\n// #endregion\n"]}

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
 import type { Readable } from 'node:stream';
 import { tx, lookup, i, id, InstantAPIError, setInstantWarningsEnabled, type InstantIssue, type TransactionChunk, type AuthToken, type User, type Query, InstantError, type QueryResponse, type InstaQLResponse, type InstaQLParams, type ValidQuery, type InstaQLFields, type InstantQuery, type InstantQueryResult, type InstantSchema, type InstantSchemaDatabase, type InstantObject, type InstantEntity, type BackwardsCompatibleSchema, type IInstantDatabase, type AttrsDefs, type CardinalityKind, type DataAttrDef, type EntitiesDef, type EntitiesWithLinks, type EntityDef, type InstantGraph, type LinkAttrDef, type LinkDef, type InstantUnknownSchemaDef, type LinksDef, type RoomsOf, type RoomsDef, type PresenceOf, type RoomHandle, type ResolveAttrs, type ValueTypes, type InstantSchemaDef, type InstantUnknownSchema, type InstaQLEntity, type InstaQLResult, type InstaQLEntitySubquery, type InstantRules, type UpdateParams, type CreateParams, type LinkParams, type RuleParams, type FileOpts, type UploadFileResponse, type DeleteFileResponse, createInstantRouteHandler, type InstantRouteHandlerPayloadByType, type InstantRouteHandlerType, type InstantRouteHandlerBody, InstantStream, type WritableStreamCtor, type ReadableStreamCtor, InstantWritableStream, InstantReadableStream, type Logger } from '@instantdb/core';
 import { SubscribeQueryCallback, SubscribeQueryResponse, SubscribeQueryPayload, SubscriptionReadyState } from './subscribe.ts';
+import { Alarms, type AlarmStatus, type AlarmAttempt, type AlarmInfo, type AlarmEvent, type SetAlarmParams, type ListAlarmsParams, type AlarmValidateOpts } from './alarms.ts';
 import { Webhooks, WebhooksManager, type WebhookAction, type WebhookStatus, type WebhookEventStatus, type WebhookInfo, type WebhookAttempt, type WebhookEventInfo, type WebhookEventsPage, type WebhookBody, type WebhookEntity, type WebhookPayload, type WebhookPayloadRecord, type WebhookPayloadRecordFor, type WebhookHandlerFn, type WebhookHandlers, type WebhookHelpers, type CreateWebhookParams, type UpdateWebhookParams } from '@instantdb/webhooks';
 type DebugCheckResult = {
     /** The ID of the record. */
@@ -459,6 +460,8 @@ declare class InstantAdminDatabase<Schema extends InstantSchemaDef<any, any, any
     rooms: Rooms<Schema>;
     impersonationOpts?: ImpersonationOpts;
     webhooks: Webhooks<Schema>;
+    /** Roko DB: ask the server to call your url at a given time. */
+    alarms: Alarms;
     tx: import("@instantdb/core").TxChunk<NonNullable<Schema>>;
     constructor(_config: Config);
     /**
@@ -604,5 +607,5 @@ declare class InstantAdminDatabase<Schema extends InstantSchemaDef<any, any, any
         origin?: string | null | undefined;
     }) => Promise<DebugTransactResult>;
 }
-export { init, init_experimental, id, tx, lookup, i, createInstantRouteHandler, type InstantRouteHandlerPayloadByType, type InstantRouteHandlerType, type InstantRouteHandlerBody, Webhooks, WebhooksManager, type WebhookAction, type WebhookStatus, type WebhookEventStatus, type WebhookInfo, type WebhookAttempt, type WebhookEventInfo, type WebhookEventsPage, type WebhookBody, type WebhookEntity, type WebhookPayload, type WebhookPayloadRecord, type WebhookPayloadRecordFor, type WebhookHandlerFn, type WebhookHandlers, type WebhookHelpers, type CreateWebhookParams, type UpdateWebhookParams, InstantAPIError, setInstantWarningsEnabled, type Config, type ImpersonationOpts, type TransactionChunk, type DebugCheckResult, type InstantAdminDatabase, type User, type InstaQLParams, type ValidQuery, type Query, InstantError, type QueryResponse, type InstaQLResponse, type InstantQuery, type InstantUnknownSchemaDef, type InstantQueryResult, type InstantSchema, type InstantSchemaDatabase, type IInstantDatabase, type InstantObject, type InstantEntity, type BackwardsCompatibleSchema, type InstaQLFields, type SubscribeQueryCallback, type SubscribeQueryResponse, type SubscribeQueryPayload, type SubscriptionReadyState, type AttrsDefs, type CardinalityKind, type DataAttrDef, type EntitiesDef, type EntitiesWithLinks, type EntityDef, type InstantGraph, type LinkAttrDef, type LinkDef, type LinksDef, type ResolveAttrs, type RoomsOf, type PresenceOf, type RoomsDef, type RoomHandle, type ValueTypes, type InstantSchemaDef, type InstantUnknownSchema, type InstaQLEntity, type InstaQLResult, type InstaQLEntitySubquery, type InstantRules, type CreateParams, type UpdateParams, type LinkParams, type FileOpts, type UploadFileResponse, type DeleteFileResponse, type DeleteManyFileResponse, type CreateReadStreamOpts, type CreateWriteStreamOpts, type InstantWritableStream, type InstantIssue, type Logger, };
+export { init, init_experimental, id, tx, lookup, i, createInstantRouteHandler, type InstantRouteHandlerPayloadByType, type InstantRouteHandlerType, type InstantRouteHandlerBody, Alarms, type AlarmStatus, type AlarmAttempt, type AlarmInfo, type AlarmEvent, type SetAlarmParams, type ListAlarmsParams, type AlarmValidateOpts, Webhooks, WebhooksManager, type WebhookAction, type WebhookStatus, type WebhookEventStatus, type WebhookInfo, type WebhookAttempt, type WebhookEventInfo, type WebhookEventsPage, type WebhookBody, type WebhookEntity, type WebhookPayload, type WebhookPayloadRecord, type WebhookPayloadRecordFor, type WebhookHandlerFn, type WebhookHandlers, type WebhookHelpers, type CreateWebhookParams, type UpdateWebhookParams, InstantAPIError, setInstantWarningsEnabled, type Config, type ImpersonationOpts, type TransactionChunk, type DebugCheckResult, type InstantAdminDatabase, type User, type InstaQLParams, type ValidQuery, type Query, InstantError, type QueryResponse, type InstaQLResponse, type InstantQuery, type InstantUnknownSchemaDef, type InstantQueryResult, type InstantSchema, type InstantSchemaDatabase, type IInstantDatabase, type InstantObject, type InstantEntity, type BackwardsCompatibleSchema, type InstaQLFields, type SubscribeQueryCallback, type SubscribeQueryResponse, type SubscribeQueryPayload, type SubscriptionReadyState, type AttrsDefs, type CardinalityKind, type DataAttrDef, type EntitiesDef, type EntitiesWithLinks, type EntityDef, type InstantGraph, type LinkAttrDef, type LinkDef, type LinksDef, type ResolveAttrs, type RoomsOf, type PresenceOf, type RoomsDef, type RoomHandle, type ValueTypes, type InstantSchemaDef, type InstantUnknownSchema, type InstaQLEntity, type InstaQLResult, type InstaQLEntitySubquery, type InstantRules, type CreateParams, type UpdateParams, type LinkParams, type FileOpts, type UploadFileResponse, type DeleteFileResponse, type DeleteManyFileResponse, type CreateReadStreamOpts, type CreateWriteStreamOpts, type InstantWritableStream, type InstantIssue, type Logger, };
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/index.js

@@ -5,6 +5,7 @@ import { subscribe, } from "./subscribe.js";
 import { parseCookie } from 'cookie';
 import { EventSource } from '@instantdb/eventsource';
 import { MessageEventPolyfill } from "./polyfill.js";
+import { Alarms, } from "./alarms.js";
 import { Webhooks, WebhooksManager, } from '@instantdb/webhooks';
 function configWithDefaults(config) {
     const defaultConfig = {
@@ -657,6 +658,8 @@ class InstantAdminDatabase {
     rooms;
     impersonationOpts;
     webhooks;
+    /** Roko DB: ask the server to call your url at a given time. */
+    alarms;
     #sseConnection = null;
     #sseBackoff = 0;
     #instantStream = null;
@@ -669,6 +672,13 @@ class InstantAdminDatabase {
         this.streams = new Streams(this.#ensureInstantStream.bind(this));
         this.rooms = new Rooms(this.config);
         this.webhooks = new Webhooks(this.config, jsonFetch);
+        this.alarms = new Alarms({
+            apiURI: this.config.apiURI,
+            appId: this.config.appId,
+            headers: () => authorizedHeaders(this.config),
+            jsonFetch,
+            verifySignature: (signatureHeader, body, opts) => this.webhooks.verifySignature(signatureHeader, body, opts),
+        });
         this.#log = createLogger(!!this.config.verbose, this.config.logger);
     }
     /**
@@ -1029,7 +1039,7 @@ class InstantAdminDatabase {
         this.#maybeShutdownConnection();
     };
 }
-export { init, init_experimental, id, tx, lookup, i, createInstantRouteHandler, Webhooks, WebhooksManager, 
+export { init, init_experimental, id, tx, lookup, i, createInstantRouteHandler, Alarms, Webhooks, WebhooksManager, 
 // error
 InstantAPIError, 
 // warnings