@rawdash/hono 0.13.0 → 0.15.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -111,6 +111,51 @@ export default app;
 
 The pure handlers in `@rawdash/server` do all the work; this package only translates HTTP. Adapters in other frameworks (Express, NestJS, etc.) would be a parallel thin layer over the same handlers.
 
+## Widget cache (optional)
+
+`createWidgetsRouter` accepts an optional `cache: (c: Context) => WidgetCache` factory. It is invoked once per request, so the returned cache can be scoped to the request's tenant / auth context:
+
+```ts
+import { createWidgetsRouter } from '@rawdash/hono';
+
+app.route(
+  '/dashboards',
+  createWidgetsRouter({
+    getConfig: (c) => loadConfig(c),
+    getStorage: (c) => loadStorage(c),
+    cache: (c) => new MyKvWidgetCache(c.env, c.get('orgId')),
+  }),
+);
+```
+
+See the `WidgetCache` section in [`@rawdash/server`](https://www.npmjs.com/package/@rawdash/server) for the interface and error-isolation semantics. Omit `cache` and behavior is identical to the no-cache path.
+
+## Deferred sync mode (queue-backed runners)
+
+By default `createSyncRouter` runs the sync **in-process**: the handler records the `queued` transition and then kicks off `runSync(config, storage)` as a background promise that iterates `config.connectors`.
+
+For deployments where the actual sync work runs **out-of-process** — typically a queue/worker setup where credentials, retries, and rate-limit budgets live in a separate runtime — pass `mode: 'deferred'`. The trigger handler then only persists the `queued` transition; the `running → succeeded/failed` transitions become the storage's responsibility, driven by the external runner:
+
+```ts
+authedApp.route(
+  '/sync',
+  createSyncRouter({
+    mode: 'deferred',
+    before: [assertScope('widgets:write')],
+    getStorage: (c) => loadStorage(c),
+    // getConfig can be omitted in deferred mode — useful when you can't
+    // materialize OSS-format Connector instances at request time.
+  }),
+);
+```
+
+In deferred mode:
+
+- `runSync` is **never** invoked by the trigger handler.
+- `getConfig` is optional and never called.
+- `markSyncQueued` is called exactly as in in-process mode; its return value drives the `{queued: true|false}` response.
+- Your external worker is responsible for calling `markSyncRunning`, `markSyncSucceeded`, and `markSyncFailed` on the same storage.
+
 ## Running on Node
 
 `@rawdash/hono` does **not** depend on `@hono/node-server` — the package stays runtime-agnostic so a Workers bundle doesn't pull Node-specific code. To run on Node, add `@hono/node-server` yourself:
@@ -137,8 +182,8 @@ Handler errors translate to JSON:
 ## Links
 
 - [rawdash docs](https://rawdash.dev)
-- [`@rawdash/server`](../server) — pure handlers + engine (the package this wraps)
-- [`@rawdash/client`](../client) — typed HTTP client (speaks the same wire contract)
+- [`@rawdash/server`](https://www.npmjs.com/package/@rawdash/server) — pure handlers + engine (the package this wraps)
+- [`@rawdash/client`](https://www.npmjs.com/package/@rawdash/client) — typed HTTP client (speaks the same wire contract)
 - [GitHub](https://github.com/rawdash/rawdash)
 - [Issues](https://github.com/rawdash/rawdash/issues)
 

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { DashboardConfig, ServerStorage } from '@rawdash/server';
+import { DashboardConfig, ServerStorage, WidgetCache, ConnectorRegistry as ConnectorRegistry$1, SecretsResolver as SecretsResolver$1 } from '@rawdash/server';
 import { Context, MiddlewareHandler, Hono } from 'hono';
+import { ConnectorRegistry, SecretsResolver } from '@rawdash/core';
 
 /**
  * Common options accepted by every `@rawdash/hono` router factory.
@@ -28,25 +29,61 @@ interface HonoStorageRouterOptions {
  */
 declare function createHealthRouter(): Hono;
 
+/**
+ * Options for `createSyncRouter`.
+ *
+ * `mode` defaults to `'in-process'`: the trigger handler kicks off
+ * `runSync` in the background, iterating `config.connectors` and
+ * instantiating each via `connectorRegistry`. In this mode both
+ * `getConfig` and `connectorRegistry` are required.
+ *
+ * In `mode: 'deferred'`, the trigger handler only records the `queued`
+ * transition; an external runner is responsible for `running →
+ * succeeded/failed`. `getConfig` and `connectorRegistry` can be omitted
+ * in this mode — useful when the deployment cannot materialize connector
+ * implementations at request time (e.g. cloud, where the actual
+ * `connector.sync(...)` call happens in a queue consumer worker).
+ */
+type SyncRouterOptions = (HonoRouterOptions & {
+    mode?: 'in-process';
+    connectorRegistry: ConnectorRegistry;
+    secretsResolver?: SecretsResolver;
+}) | {
+    mode: 'deferred';
+    getStorage: HonoRouterOptions['getStorage'];
+    getConfig?: HonoRouterOptions['getConfig'];
+    before?: MiddlewareHandler[];
+};
 /**
  * `POST /` — triggers a sync, returning immediately with
- * `{queued: true|false}`. The sync runs in the background.
+ * `{queued: true|false}`. In `mode: 'in-process'` (default) the sync
+ * runs in the background; in `mode: 'deferred'` the handler only
+ * persists the `queued` transition and the external runner takes it
+ * from there.
  *
  * Mount at `/sync`.
  */
-declare function createSyncRouter(opts: HonoRouterOptions): Hono;
+declare function createSyncRouter(opts: SyncRouterOptions): Hono;
 /**
  * `GET /` — returns the current `SyncState`. Mount at `/sync/state`.
  */
 declare function createSyncStateRouter(opts: HonoStorageRouterOptions): Hono;
 
+interface HonoWidgetsRouterOptions extends HonoRouterOptions {
+    /**
+     * Optional per-request factory returning a `WidgetCache`. Invoked once
+     * per request so the cache can be scoped to the request's tenant/auth
+     * context. When omitted, widgets are resolved fresh on every request.
+     */
+    cache?: (c: Context) => WidgetCache;
+}
 /**
  * - `GET /:dashboardId/widgets` → `WidgetsListResponse`
  * - `GET /:dashboardId/widgets/:widgetId` → `CachedWidget`
  *
  * Mount at `/dashboards`.
  */
-declare function createWidgetsRouter(opts: HonoRouterOptions): Hono;
+declare function createWidgetsRouter(opts: HonoWidgetsRouterOptions): Hono;
 
 /**
  * `POST /retain` — runs the retention policy once. Coalesces concurrent
@@ -73,6 +110,19 @@ declare function startRetentionLoop(opts: RetentionLoopOptions): () => void;
 
 interface MountEngineOptions {
     storage?: ServerStorage;
+    /**
+     * Registry mapping connector type id (e.g. `'github-actions'`) to the
+     * connector class. Used to instantiate connector implementations on
+     * demand from the declarative entries in `DashboardConfig.connectors`.
+     * Required for sync and retention to function.
+     */
+    connectorRegistry: ConnectorRegistry$1;
+    /**
+     * Resolves `secret('NAME')` markers in connector configs. Defaults to
+     * `EnvSecretsResolver` (process.env lookup) inside connector
+     * instantiation.
+     */
+    secretsResolver?: SecretsResolver$1;
     /** Set false to skip the background retention timer (e.g. on serverless). */
     startRetention?: boolean;
 }
@@ -90,6 +140,6 @@ interface MountEngineResult {
  * request, skip this and compose the router factories directly with
  * per-request `getConfig` / `getStorage` and `before` middleware.
  */
-declare function mountEngine(config: DashboardConfig, options?: MountEngineOptions): MountEngineResult;
+declare function mountEngine(config: DashboardConfig, options: MountEngineOptions): MountEngineResult;
 
-export { type HonoRouterOptions, type HonoStorageRouterOptions, type MountEngineOptions, type MountEngineResult, type RetentionLoopOptions, createHealthRouter, createRetentionRouter, createSyncRouter, createSyncStateRouter, createWidgetsRouter, mountEngine, startRetentionLoop };
+export { type HonoRouterOptions, type HonoStorageRouterOptions, type HonoWidgetsRouterOptions, type MountEngineOptions, type MountEngineResult, type RetentionLoopOptions, type SyncRouterOptions, createHealthRouter, createRetentionRouter, createSyncRouter, createSyncStateRouter, createWidgetsRouter, mountEngine, startRetentionLoop };

package/dist/index.js

@@ -43,7 +43,26 @@ function createSyncRouter(opts) {
   applyBefore(app, opts.before);
   app.post("/", async (c) => {
     try {
-      return c.json(await triggerSync(makeEngineContext(c, opts)));
+      if (opts.mode === "deferred") {
+        const getConfig = opts.getConfig;
+        return c.json(
+          await triggerSync(
+            {
+              getStorage: () => opts.getStorage(c),
+              getConfig: getConfig ? () => getConfig(c) : void 0
+            },
+            { mode: "deferred" }
+          )
+        );
+      }
+      return c.json(
+        await triggerSync({
+          getStorage: () => opts.getStorage(c),
+          getConfig: () => opts.getConfig(c),
+          connectorRegistry: opts.connectorRegistry,
+          secretsResolver: opts.secretsResolver
+        })
+      );
     } catch (err) {
       return mapError(c, err);
     }
@@ -81,7 +100,8 @@ function createWidgetsRouter(opts) {
       return c.json(
         await listWidgets(
           makeEngineContext(c, opts),
-          c.req.param("dashboardId")
+          c.req.param("dashboardId"),
+          opts.cache?.(c)
         )
       );
     } catch (err) {
@@ -94,7 +114,8 @@ function createWidgetsRouter(opts) {
         await getWidget(
           makeEngineContext(c, opts),
           c.req.param("dashboardId"),
-          c.req.param("widgetId")
+          c.req.param("widgetId"),
+          opts.cache?.(c)
         )
       );
     } catch (err) {
@@ -141,29 +162,41 @@ function startRetentionLoop(opts) {
     if (inFlight || stopped) {
       return;
     }
-    const config = await opts.getConfig();
-    if (!config.retention || !hasPruningPolicy(config.retention)) {
-      return;
-    }
-    const storage = await opts.getStorage();
-    inFlight = runRetention(config, storage).finally(() => {
-      inFlight = null;
-    });
     try {
+      const config = await opts.getConfig();
+      if (!config.retention || !hasPruningPolicy(config.retention)) {
+        return;
+      }
+      const storage = await opts.getStorage();
+      inFlight = runRetention(config, storage).finally(() => {
+        inFlight = null;
+      });
       await inFlight;
     } catch (err) {
       console.error("retention run failed", err);
     }
   };
   void (async () => {
-    const config = await opts.getConfig();
-    if (!config.retention || !hasPruningPolicy(config.retention)) {
-      return;
+    try {
+      const config = await opts.getConfig();
+      if (!config.retention || !hasPruningPolicy(config.retention)) {
+        return;
+      }
+      if (stopped) {
+        return;
+      }
+      const intervalMs = opts.intervalMs ?? config.retention.intervalMs ?? DEFAULT_RETENTION_INTERVAL_MS;
+      const created = setInterval(() => {
+        void tick();
+      }, intervalMs);
+      if (stopped) {
+        clearInterval(created);
+      } else {
+        timer = created;
+      }
+    } catch (err) {
+      console.error("retention loop startup failed", err);
     }
-    const intervalMs = opts.intervalMs ?? config.retention.intervalMs ?? DEFAULT_RETENTION_INTERVAL_MS;
-    timer = setInterval(() => {
-      void tick();
-    }, intervalMs);
   })();
   return () => {
     stopped = true;
@@ -177,13 +210,22 @@ function startRetentionLoop(opts) {
 // src/mount.ts
 import { InMemoryStorage, ROUTES } from "@rawdash/server";
 import { Hono as Hono5 } from "hono";
-function mountEngine(config, options = {}) {
+function mountEngine(config, options) {
   const storage = options.storage ?? new InMemoryStorage();
+  const { connectorRegistry, secretsResolver } = options;
   const getConfig = () => config;
   const getStorage = () => storage;
   const app = new Hono5();
   app.route("/dashboards", createWidgetsRouter({ getConfig, getStorage }));
-  app.route(ROUTES.sync, createSyncRouter({ getConfig, getStorage }));
+  app.route(
+    ROUTES.sync,
+    createSyncRouter({
+      getConfig,
+      getStorage,
+      connectorRegistry,
+      secretsResolver
+    })
+  );
   app.route(ROUTES.syncState, createSyncStateRouter({ getStorage }));
   app.route("/retention", createRetentionRouter({ getConfig, getStorage }));
   app.route(ROUTES.health, createHealthRouter());

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/health.ts","../src/sync.ts","../src/shared.ts","../src/widgets.ts","../src/retention.ts","../src/mount.ts"],"sourcesContent":["import { getHealth } from '@rawdash/server';\nimport { Hono } from 'hono';\n\n/**\n * Liveness probe — returns `{status:'ok'}` synchronously, no storage\n * access. Mount at `/health` (or wherever your platform's probe expects).\n */\nexport function createHealthRouter(): Hono {\n  const app = new Hono();\n  app.get('/', (c) => c.json(getHealth()));\n  return app;\n}\n","import { getSyncStateHandler, triggerSync } from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions, HonoStorageRouterOptions } from './shared';\nimport { applyBefore, makeEngineContext, mapError } from './shared';\n\n/**\n * `POST /` — triggers a sync, returning immediately with\n * `{queued: true|false}`. The sync runs in the background.\n *\n * Mount at `/sync`.\n */\nexport function createSyncRouter(opts: HonoRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n  app.post('/', async (c) => {\n    try {\n      return c.json(await triggerSync(makeEngineContext(c, opts)));\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n  return app;\n}\n\n/**\n * `GET /` — returns the current `SyncState`. Mount at `/sync/state`.\n */\nexport function createSyncStateRouter(opts: HonoStorageRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n  app.get('/', async (c) => {\n    try {\n      // sync-state only needs storage, but reuse the EngineContext shape\n      // for handler uniformity. getConfig is a no-op here.\n      return c.json(\n        await getSyncStateHandler({\n          getConfig: () => {\n            throw new Error('getConfig should not be called by sync-state');\n          },\n          getStorage: () => opts.getStorage(c),\n        }),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n  return app;\n}\n","import type { EngineContext } from '@rawdash/server';\nimport type { DashboardConfig, ServerStorage } from '@rawdash/server';\nimport { isRawdashError } from '@rawdash/server';\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { Hono } from 'hono';\n\n/**\n * Common options accepted by every `@rawdash/hono` router factory.\n *\n * `getConfig` / `getStorage` are invoked per-request with the Hono\n * `Context`, so adapters can derive the config or storage from request\n * state (e.g. a path parameter, an id attached by an auth middleware, or\n * environment bindings).\n *\n * `before` middleware runs before any handler — typically auth/scope\n * checks.\n */\nexport interface HonoRouterOptions {\n  getConfig: (c: Context) => DashboardConfig | Promise<DashboardConfig>;\n  getStorage: (c: Context) => ServerStorage | Promise<ServerStorage>;\n  before?: MiddlewareHandler[];\n}\n\nexport interface HonoStorageRouterOptions {\n  getStorage: (c: Context) => ServerStorage | Promise<ServerStorage>;\n  before?: MiddlewareHandler[];\n}\n\nexport function makeEngineContext(\n  c: Context,\n  opts: HonoRouterOptions,\n): EngineContext {\n  return {\n    getConfig: () => opts.getConfig(c),\n    getStorage: () => opts.getStorage(c),\n  };\n}\n\nexport function applyBefore(app: Hono, before?: MiddlewareHandler[]): void {\n  if (!before) {\n    return;\n  }\n  for (const mw of before) {\n    app.use('*', mw);\n  }\n}\n\n/**\n * Translate a thrown error into a Hono JSON response. `RawdashError`\n * becomes a structured `{error, code}` body at the carried status; any\n * other error is re-thrown for Hono's own error handling.\n */\nexport function mapError(c: Context, err: unknown): Response {\n  if (isRawdashError(err)) {\n    return c.json(\n      { error: err.message, code: err.code },\n      err.status as Parameters<typeof c.json>[1],\n    );\n  }\n  throw err;\n}\n","import { getWidget, listWidgets } from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions } from './shared';\nimport { applyBefore, makeEngineContext, mapError } from './shared';\n\n/**\n * - `GET /:dashboardId/widgets` → `WidgetsListResponse`\n * - `GET /:dashboardId/widgets/:widgetId` → `CachedWidget`\n *\n * Mount at `/dashboards`.\n */\nexport function createWidgetsRouter(opts: HonoRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n\n  app.get('/:dashboardId/widgets', async (c) => {\n    try {\n      return c.json(\n        await listWidgets(\n          makeEngineContext(c, opts),\n          c.req.param('dashboardId'),\n        ),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n\n  app.get('/:dashboardId/widgets/:widgetId', async (c) => {\n    try {\n      return c.json(\n        await getWidget(\n          makeEngineContext(c, opts),\n          c.req.param('dashboardId'),\n          c.req.param('widgetId'),\n        ),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n\n  return app;\n}\n","import type { DashboardConfig, ServerStorage } from '@rawdash/server';\nimport {\n  DEFAULT_RETENTION_INTERVAL_MS,\n  hasPruningPolicy,\n  runRetention,\n  runRetentionOnce,\n} from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions } from './shared';\nimport { applyBefore, makeEngineContext, mapError } from './shared';\n\n/**\n * `POST /retain` — runs the retention policy once. Coalesces concurrent\n * calls so multiple requests during an in-flight run share the same\n * promise.\n *\n * Mount at `/retention`.\n */\nexport function createRetentionRouter(opts: HonoRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n\n  let inFlight: Promise<void> | null = null;\n\n  app.post('/retain', async (c) => {\n    try {\n      if (!inFlight) {\n        const ctx = makeEngineContext(c, opts);\n        inFlight = runRetentionOnce(ctx).finally(() => {\n          inFlight = null;\n        });\n      }\n      await inFlight;\n      return c.json({ triggered: true });\n    } catch (err) {\n      console.error('retention run failed', err);\n      return mapError(c, err);\n    }\n  });\n\n  return app;\n}\n\nexport interface RetentionLoopOptions {\n  getConfig: () => DashboardConfig | Promise<DashboardConfig>;\n  getStorage: () => ServerStorage | Promise<ServerStorage>;\n  intervalMs?: number;\n}\n\n/**\n * Start a background loop that periodically runs the retention policy.\n * Returns a `stop()` function that clears the interval.\n *\n * Only useful on long-lived runtimes (Node, Bun, Deno). In serverless\n * runtimes (Workers, Lambda) use the platform's native scheduler\n * (Cron Triggers, CloudWatch Events) to call `POST /retention/retain`.\n */\nexport function startRetentionLoop(opts: RetentionLoopOptions): () => void {\n  let stopped = false;\n  let inFlight: Promise<void> | null = null;\n  let timer: ReturnType<typeof setInterval> | null = null;\n\n  const tick = async (): Promise<void> => {\n    if (inFlight || stopped) {\n      return;\n    }\n    const config = await opts.getConfig();\n    if (!config.retention || !hasPruningPolicy(config.retention)) {\n      return;\n    }\n    const storage = await opts.getStorage();\n    inFlight = runRetention(config, storage).finally(() => {\n      inFlight = null;\n    });\n    try {\n      await inFlight;\n    } catch (err) {\n      console.error('retention run failed', err);\n    }\n  };\n\n  void (async () => {\n    const config = await opts.getConfig();\n    if (!config.retention || !hasPruningPolicy(config.retention)) {\n      return;\n    }\n    const intervalMs =\n      opts.intervalMs ??\n      config.retention.intervalMs ??\n      DEFAULT_RETENTION_INTERVAL_MS;\n    timer = setInterval(() => {\n      void tick();\n    }, intervalMs);\n  })();\n\n  return () => {\n    stopped = true;\n    if (timer !== null) {\n      clearInterval(timer);\n      timer = null;\n    }\n  };\n}\n","import type { DashboardConfig, ServerStorage } from '@rawdash/server';\nimport { InMemoryStorage, ROUTES } from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport { createHealthRouter } from './health';\nimport { createRetentionRouter, startRetentionLoop } from './retention';\nimport { createSyncRouter, createSyncStateRouter } from './sync';\nimport { createWidgetsRouter } from './widgets';\n\nexport interface MountEngineOptions {\n  storage?: ServerStorage;\n  /** Set false to skip the background retention timer (e.g. on serverless). */\n  startRetention?: boolean;\n}\n\nexport interface MountEngineResult {\n  app: Hono;\n  stop(): void;\n}\n\n/**\n * Convenience wrapper for the common case: builds a Hono app with all\n * standard rawdash routes mounted at their canonical paths, backed by\n * one `DashboardConfig` and one `ServerStorage` (defaults to\n * `InMemoryStorage`).\n *\n * For deployments that need auth or that look up config / storage per\n * request, skip this and compose the router factories directly with\n * per-request `getConfig` / `getStorage` and `before` middleware.\n */\nexport function mountEngine(\n  config: DashboardConfig,\n  options: MountEngineOptions = {},\n): MountEngineResult {\n  const storage: ServerStorage = options.storage ?? new InMemoryStorage();\n  const getConfig = (): DashboardConfig => config;\n  const getStorage = (): ServerStorage => storage;\n\n  const app = new Hono();\n  app.route('/dashboards', createWidgetsRouter({ getConfig, getStorage }));\n  app.route(ROUTES.sync, createSyncRouter({ getConfig, getStorage }));\n  app.route(ROUTES.syncState, createSyncStateRouter({ getStorage }));\n  app.route('/retention', createRetentionRouter({ getConfig, getStorage }));\n  app.route(ROUTES.health, createHealthRouter());\n\n  let stopRetention: (() => void) | null = null;\n  if (options.startRetention !== false) {\n    stopRetention = startRetentionLoop({ getConfig, getStorage });\n  }\n\n  return {\n    app,\n    stop() {\n      if (stopRetention) {\n        stopRetention();\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["Hono","Hono","Hono","Hono","Hono","Hono","Hono","Hono"]}
+{"version":3,"sources":["../src/health.ts","../src/sync.ts","../src/shared.ts","../src/widgets.ts","../src/retention.ts","../src/mount.ts"],"sourcesContent":["import { getHealth } from '@rawdash/server';\nimport { Hono } from 'hono';\n\n/**\n * Liveness probe — returns `{status:'ok'}` synchronously, no storage\n * access. Mount at `/health` (or wherever your platform's probe expects).\n */\nexport function createHealthRouter(): Hono {\n  const app = new Hono();\n  app.get('/', (c) => c.json(getHealth()));\n  return app;\n}\n","import type { ConnectorRegistry, SecretsResolver } from '@rawdash/core';\nimport { getSyncStateHandler, triggerSync } from '@rawdash/server';\nimport type { MiddlewareHandler } from 'hono';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions, HonoStorageRouterOptions } from './shared';\nimport { applyBefore, mapError } from './shared';\n\n/**\n * Options for `createSyncRouter`.\n *\n * `mode` defaults to `'in-process'`: the trigger handler kicks off\n * `runSync` in the background, iterating `config.connectors` and\n * instantiating each via `connectorRegistry`. In this mode both\n * `getConfig` and `connectorRegistry` are required.\n *\n * In `mode: 'deferred'`, the trigger handler only records the `queued`\n * transition; an external runner is responsible for `running →\n * succeeded/failed`. `getConfig` and `connectorRegistry` can be omitted\n * in this mode — useful when the deployment cannot materialize connector\n * implementations at request time (e.g. cloud, where the actual\n * `connector.sync(...)` call happens in a queue consumer worker).\n */\nexport type SyncRouterOptions =\n  | (HonoRouterOptions & {\n      mode?: 'in-process';\n      connectorRegistry: ConnectorRegistry;\n      secretsResolver?: SecretsResolver;\n    })\n  | {\n      mode: 'deferred';\n      getStorage: HonoRouterOptions['getStorage'];\n      getConfig?: HonoRouterOptions['getConfig'];\n      before?: MiddlewareHandler[];\n    };\n\n/**\n * `POST /` — triggers a sync, returning immediately with\n * `{queued: true|false}`. In `mode: 'in-process'` (default) the sync\n * runs in the background; in `mode: 'deferred'` the handler only\n * persists the `queued` transition and the external runner takes it\n * from there.\n *\n * Mount at `/sync`.\n */\nexport function createSyncRouter(opts: SyncRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n  app.post('/', async (c) => {\n    try {\n      if (opts.mode === 'deferred') {\n        const getConfig = opts.getConfig;\n        return c.json(\n          await triggerSync(\n            {\n              getStorage: () => opts.getStorage(c),\n              getConfig: getConfig ? () => getConfig(c) : undefined,\n            },\n            { mode: 'deferred' },\n          ),\n        );\n      }\n      return c.json(\n        await triggerSync({\n          getStorage: () => opts.getStorage(c),\n          getConfig: () => opts.getConfig(c),\n          connectorRegistry: opts.connectorRegistry,\n          secretsResolver: opts.secretsResolver,\n        }),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n  return app;\n}\n\n/**\n * `GET /` — returns the current `SyncState`. Mount at `/sync/state`.\n */\nexport function createSyncStateRouter(opts: HonoStorageRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n  app.get('/', async (c) => {\n    try {\n      return c.json(\n        await getSyncStateHandler({\n          getConfig: () => {\n            throw new Error('getConfig should not be called by sync-state');\n          },\n          getStorage: () => opts.getStorage(c),\n        }),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n  return app;\n}\n","import type { EngineContext } from '@rawdash/server';\nimport type { DashboardConfig, ServerStorage } from '@rawdash/server';\nimport { isRawdashError } from '@rawdash/server';\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { Hono } from 'hono';\n\n/**\n * Common options accepted by every `@rawdash/hono` router factory.\n *\n * `getConfig` / `getStorage` are invoked per-request with the Hono\n * `Context`, so adapters can derive the config or storage from request\n * state (e.g. a path parameter, an id attached by an auth middleware, or\n * environment bindings).\n *\n * `before` middleware runs before any handler — typically auth/scope\n * checks.\n */\nexport interface HonoRouterOptions {\n  getConfig: (c: Context) => DashboardConfig | Promise<DashboardConfig>;\n  getStorage: (c: Context) => ServerStorage | Promise<ServerStorage>;\n  before?: MiddlewareHandler[];\n}\n\nexport interface HonoStorageRouterOptions {\n  getStorage: (c: Context) => ServerStorage | Promise<ServerStorage>;\n  before?: MiddlewareHandler[];\n}\n\nexport function makeEngineContext(\n  c: Context,\n  opts: HonoRouterOptions,\n): EngineContext {\n  return {\n    getConfig: () => opts.getConfig(c),\n    getStorage: () => opts.getStorage(c),\n  };\n}\n\nexport function applyBefore(app: Hono, before?: MiddlewareHandler[]): void {\n  if (!before) {\n    return;\n  }\n  for (const mw of before) {\n    app.use('*', mw);\n  }\n}\n\n/**\n * Translate a thrown error into a Hono JSON response. `RawdashError`\n * becomes a structured `{error, code}` body at the carried status; any\n * other error is re-thrown for Hono's own error handling.\n */\nexport function mapError(c: Context, err: unknown): Response {\n  if (isRawdashError(err)) {\n    return c.json(\n      { error: err.message, code: err.code },\n      err.status as Parameters<typeof c.json>[1],\n    );\n  }\n  throw err;\n}\n","import type { WidgetCache } from '@rawdash/server';\nimport { getWidget, listWidgets } from '@rawdash/server';\nimport type { Context } from 'hono';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions } from './shared';\nimport { applyBefore, makeEngineContext, mapError } from './shared';\n\nexport interface HonoWidgetsRouterOptions extends HonoRouterOptions {\n  /**\n   * Optional per-request factory returning a `WidgetCache`. Invoked once\n   * per request so the cache can be scoped to the request's tenant/auth\n   * context. When omitted, widgets are resolved fresh on every request.\n   */\n  cache?: (c: Context) => WidgetCache;\n}\n\n/**\n * - `GET /:dashboardId/widgets` → `WidgetsListResponse`\n * - `GET /:dashboardId/widgets/:widgetId` → `CachedWidget`\n *\n * Mount at `/dashboards`.\n */\nexport function createWidgetsRouter(opts: HonoWidgetsRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n\n  app.get('/:dashboardId/widgets', async (c) => {\n    try {\n      return c.json(\n        await listWidgets(\n          makeEngineContext(c, opts),\n          c.req.param('dashboardId'),\n          opts.cache?.(c),\n        ),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n\n  app.get('/:dashboardId/widgets/:widgetId', async (c) => {\n    try {\n      return c.json(\n        await getWidget(\n          makeEngineContext(c, opts),\n          c.req.param('dashboardId'),\n          c.req.param('widgetId'),\n          opts.cache?.(c),\n        ),\n      );\n    } catch (err) {\n      return mapError(c, err);\n    }\n  });\n\n  return app;\n}\n","import type { DashboardConfig, ServerStorage } from '@rawdash/server';\nimport {\n  DEFAULT_RETENTION_INTERVAL_MS,\n  hasPruningPolicy,\n  runRetention,\n  runRetentionOnce,\n} from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport type { HonoRouterOptions } from './shared';\nimport { applyBefore, makeEngineContext, mapError } from './shared';\n\n/**\n * `POST /retain` — runs the retention policy once. Coalesces concurrent\n * calls so multiple requests during an in-flight run share the same\n * promise.\n *\n * Mount at `/retention`.\n */\nexport function createRetentionRouter(opts: HonoRouterOptions): Hono {\n  const app = new Hono();\n  applyBefore(app, opts.before);\n\n  let inFlight: Promise<void> | null = null;\n\n  app.post('/retain', async (c) => {\n    try {\n      if (!inFlight) {\n        const ctx = makeEngineContext(c, opts);\n        inFlight = runRetentionOnce(ctx).finally(() => {\n          inFlight = null;\n        });\n      }\n      await inFlight;\n      return c.json({ triggered: true });\n    } catch (err) {\n      console.error('retention run failed', err);\n      return mapError(c, err);\n    }\n  });\n\n  return app;\n}\n\nexport interface RetentionLoopOptions {\n  getConfig: () => DashboardConfig | Promise<DashboardConfig>;\n  getStorage: () => ServerStorage | Promise<ServerStorage>;\n  intervalMs?: number;\n}\n\n/**\n * Start a background loop that periodically runs the retention policy.\n * Returns a `stop()` function that clears the interval.\n *\n * Only useful on long-lived runtimes (Node, Bun, Deno). In serverless\n * runtimes (Workers, Lambda) use the platform's native scheduler\n * (Cron Triggers, CloudWatch Events) to call `POST /retention/retain`.\n */\nexport function startRetentionLoop(opts: RetentionLoopOptions): () => void {\n  let stopped = false;\n  let inFlight: Promise<void> | null = null;\n  let timer: ReturnType<typeof setInterval> | null = null;\n\n  const tick = async (): Promise<void> => {\n    if (inFlight || stopped) {\n      return;\n    }\n    try {\n      const config = await opts.getConfig();\n      if (!config.retention || !hasPruningPolicy(config.retention)) {\n        return;\n      }\n      const storage = await opts.getStorage();\n      inFlight = runRetention(config, storage).finally(() => {\n        inFlight = null;\n      });\n      await inFlight;\n    } catch (err) {\n      console.error('retention run failed', err);\n    }\n  };\n\n  void (async () => {\n    try {\n      const config = await opts.getConfig();\n      if (!config.retention || !hasPruningPolicy(config.retention)) {\n        return;\n      }\n      // Re-check `stopped` after the async getConfig in case stop()\n      // was called while we were awaiting it.\n      if (stopped) {\n        return;\n      }\n      const intervalMs =\n        opts.intervalMs ??\n        config.retention.intervalMs ??\n        DEFAULT_RETENTION_INTERVAL_MS;\n      const created = setInterval(() => {\n        void tick();\n      }, intervalMs);\n      // Race with stop(): if stop() ran between the check above and\n      // setInterval, clear it immediately rather than leaving a\n      // lingering timer behind.\n      if (stopped) {\n        clearInterval(created);\n      } else {\n        timer = created;\n      }\n    } catch (err) {\n      console.error('retention loop startup failed', err);\n    }\n  })();\n\n  return () => {\n    stopped = true;\n    if (timer !== null) {\n      clearInterval(timer);\n      timer = null;\n    }\n  };\n}\n","import type {\n  ConnectorRegistry,\n  DashboardConfig,\n  SecretsResolver,\n  ServerStorage,\n} from '@rawdash/server';\nimport { InMemoryStorage, ROUTES } from '@rawdash/server';\nimport { Hono } from 'hono';\n\nimport { createHealthRouter } from './health';\nimport { createRetentionRouter, startRetentionLoop } from './retention';\nimport { createSyncRouter, createSyncStateRouter } from './sync';\nimport { createWidgetsRouter } from './widgets';\n\nexport interface MountEngineOptions {\n  storage?: ServerStorage;\n  /**\n   * Registry mapping connector type id (e.g. `'github-actions'`) to the\n   * connector class. Used to instantiate connector implementations on\n   * demand from the declarative entries in `DashboardConfig.connectors`.\n   * Required for sync and retention to function.\n   */\n  connectorRegistry: ConnectorRegistry;\n  /**\n   * Resolves `secret('NAME')` markers in connector configs. Defaults to\n   * `EnvSecretsResolver` (process.env lookup) inside connector\n   * instantiation.\n   */\n  secretsResolver?: SecretsResolver;\n  /** Set false to skip the background retention timer (e.g. on serverless). */\n  startRetention?: boolean;\n}\n\nexport interface MountEngineResult {\n  app: Hono;\n  stop(): void;\n}\n\n/**\n * Convenience wrapper for the common case: builds a Hono app with all\n * standard rawdash routes mounted at their canonical paths, backed by\n * one `DashboardConfig` and one `ServerStorage` (defaults to\n * `InMemoryStorage`).\n *\n * For deployments that need auth or that look up config / storage per\n * request, skip this and compose the router factories directly with\n * per-request `getConfig` / `getStorage` and `before` middleware.\n */\nexport function mountEngine(\n  config: DashboardConfig,\n  options: MountEngineOptions,\n): MountEngineResult {\n  const storage: ServerStorage = options.storage ?? new InMemoryStorage();\n  const { connectorRegistry, secretsResolver } = options;\n  const getConfig = (): DashboardConfig => config;\n  const getStorage = (): ServerStorage => storage;\n\n  const app = new Hono();\n  app.route('/dashboards', createWidgetsRouter({ getConfig, getStorage }));\n  app.route(\n    ROUTES.sync,\n    createSyncRouter({\n      getConfig,\n      getStorage,\n      connectorRegistry,\n      secretsResolver,\n    }),\n  );\n  app.route(ROUTES.syncState, createSyncStateRouter({ getStorage }));\n  app.route('/retention', createRetentionRouter({ getConfig, getStorage }));\n  app.route(ROUTES.health, createHealthRouter());\n\n  let stopRetention: (() => void) | null = null;\n  if (options.startRetention !== false) {\n    stopRetention = startRetentionLoop({ getConfig, getStorage });\n  }\n\n  return {\n    app,\n    stop() {\n      if (stopRetention) {\n        stopRetention();\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["Hono","Hono","Hono","Hono","Hono","Hono","Hono","Hono"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rawdash/hono",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Hono adapter for rawdash — router factories and helpers that mount @rawdash/server handlers onto a Hono app. Runtime-agnostic (Workers, Node, Bun, Deno).",
   "license": "Apache-2.0",
   "type": "module",
@@ -21,23 +21,23 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src",
-    "test": "vitest run"
-  },
   "peerDependencies": {
     "hono": "^4.0.0"
   },
   "dependencies": {
-    "@rawdash/core": "workspace:*",
-    "@rawdash/server": "workspace:*"
+    "@rawdash/core": "0.15.0",
+    "@rawdash/server": "0.15.0"
   },
   "devDependencies": {
     "hono": "^4.7.7",
     "tsup": "^8.0.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
   }
-}
+}