@storyshelf/app 0.5.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhant Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# @storyshelf/app
+
+The StoryShelf HTTP app: `createShelfApp()` composes database, storage, capture, auth, and git-host adapters (all from `@storyshelf/core`) into a complete Hono application — JSON API under `/api/v1` plus server-rendered HTML pages (hono/jsx + HTMX, no client framework).
+
+## Quick start
+
+```ts
+import { createShelfApp } from "@storyshelf/app";
+
+const app = createShelfApp({ database, storage, captureRunner });
+await app.lifecycle.init();
+
+serve({ fetch: app.fetch, port: 3000 });
+```
+
+## How it fits in
+
+`app` owns everything HTTP: `routers/`, `pages/`, `ui/`, `middleware/`, the request `store`, and vendored assets. All domain logic — adapter interfaces, models, schema, capture pipeline, retention, diff — lives in `@storyshelf/core` and is imported here through its granular subpaths (never the core barrel, which is now domain-only). Queue and remote workers depend on core alone and pull zero HTTP modules.

package/dist/app-types.d.mts

@@ -0,0 +1,54 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { OpenAPIHono } from "@hono/zod-openapi";
+import { AdapterSetupResult } from "@storyshelf/core/adapter/setup";
+import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
+import { AuthUser } from "@storyshelf/core/types";
+import { ShelfConfig, UIConfig } from "@storyshelf/core/config";
+import { Logger, createShelfLogger } from "@storyshelf/core/logger";
+import { CaptureQueue } from "@storyshelf/core/adapter/capture-queue";
+import { DatabaseAdapter } from "@storyshelf/core/adapter/database";
+import { GitHostProvider } from "@storyshelf/core/adapter/git-host";
+import { StorageAdapter } from "@storyshelf/core/adapter/storage";
+//#region src/app-types.d.ts
+/** Per-request shelf context (adapters, config, user, capture queue). */
+interface ShelfContext {
+  requestId?: string;
+  db: DatabaseAdapter;
+  storage: StorageAdapter;
+  config: ShelfConfig;
+  ui: UIConfig;
+  logger: ReturnType<typeof createShelfLogger>;
+  user: AuthUser | null;
+  authEnabled: boolean;
+  enqueueCapture?: (buildId: string, reqId?: string) => Promise<void>;
+  captureQueue: CaptureQueue | null;
+  gitHosts: GitHostProvider[];
+  notifiers: NotifierProvider[];
+}
+/** Hono router type carrying the shelf context variables. */
+type ShelfRouter = OpenAPIHono<{
+  Variables: ShelfContext;
+}>;
+/** App-scoped adapter lifecycle namespace (single `lifecycle` prop avoids Hono collisions). */
+interface ShelfLifecycle {
+  /** Settled summary of the eager background setup run; never rejects. */
+  readonly ready: Promise<AdapterSetupResult>;
+  /** The resolved logger: the passed-in instance, or the app-created default. */
+  readonly logger: Logger;
+  /**
+   * Fail-fast await for server startup (`await app.lifecycle.setup()`).
+   * Re-runs setup so transient failures are retryable; throws AdapterLifecycleError.
+   * Optional — when skipped, the first request gates on `ready` instead.
+   */
+  setup(): Promise<void>;
+  /** Graceful teardown for SIGTERM/SIGINT (`await app.lifecycle.teardown()`). Idempotent. */
+  teardown(): Promise<void>;
+}
+/** Shelf app with the shelf lifecycle namespace attached. */
+type ShelfApp = ShelfRouter & {
+  readonly lifecycle: ShelfLifecycle;
+};
+//#endregion
+export { ShelfApp, ShelfContext, ShelfLifecycle, ShelfRouter };
+//# sourceMappingURL=app-types.d.mts.map

package/dist/asset-manifest.mjs

@@ -0,0 +1,41 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { contentHash, iconSprite, iconSpriteHash, iconSpriteHref } from "./ui/icons/sprite.mjs";
+import { findAsset } from "./asset-paths.mjs";
+import { readFileSync } from "node:fs";
+//#region src/asset-manifest.ts
+/**
+* Static assets with content-addressed URLs. A URL that embeds the content
+* hash may be cached forever (`immutable`): changing the file changes the
+* URL. Loaded synchronously once so the page shell can reference the URLs.
+*/
+const htmxSource = readFileSync(findAsset("htmx.min.js", import.meta.url), "utf8");
+const htmxHash = contentHash(htmxSource);
+/**
+* The StoryShelf brand mark. Serves as the enforced favicon and as the default
+* sidebar logo when `ui.logo` is not set.
+*/
+const markSource = readFileSync(findAsset("mark.svg", import.meta.url), "utf8");
+const markHash = contentHash(markSource);
+const assetManifest = {
+	htmx: {
+		source: htmxSource,
+		hash: htmxHash,
+		href: `/assets/htmx-${htmxHash}.js`
+	},
+	icons: {
+		source: iconSprite,
+		hash: iconSpriteHash,
+		href: iconSpriteHref
+	},
+	mark: {
+		source: markSource,
+		hash: markHash,
+		href: `/assets/mark-${markHash}.svg`
+	}
+};
+//#endregion
+export { assetManifest };
+
+//# sourceMappingURL=asset-manifest.mjs.map

package/dist/asset-manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manifest.mjs","names":[],"sources":["../src/asset-manifest.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { findAsset } from \"./asset-paths.ts\";\nimport { contentHash, iconSprite, iconSpriteHash, iconSpriteHref } from \"./ui/icons/sprite.ts\";\n\n/**\n * Static assets with content-addressed URLs. A URL that embeds the content\n * hash may be cached forever (`immutable`): changing the file changes the\n * URL. Loaded synchronously once so the page shell can reference the URLs.\n */\nconst htmxSource = readFileSync(findAsset(\"htmx.min.js\", import.meta.url), \"utf8\");\nconst htmxHash = contentHash(htmxSource);\n\n/**\n * The StoryShelf brand mark. Serves as the enforced favicon and as the default\n * sidebar logo when `ui.logo` is not set.\n */\nconst markSource = readFileSync(findAsset(\"mark.svg\", import.meta.url), \"utf8\");\nconst markHash = contentHash(markSource);\n\nexport const assetManifest = {\n  htmx: { source: htmxSource, hash: htmxHash, href: `/assets/htmx-${htmxHash}.js` },\n  icons: { source: iconSprite, hash: iconSpriteHash, href: iconSpriteHref },\n  mark: { source: markSource, hash: markHash, href: `/assets/mark-${markHash}.svg` },\n} as const;\n"],"mappings":";;;;;;;;;;;;AASA,MAAM,aAAa,aAAa,UAAU,eAAe,YAAY,GAAG,GAAG,MAAM;AACjF,MAAM,WAAW,YAAY,UAAU;;;;;AAMvC,MAAM,aAAa,aAAa,UAAU,YAAY,YAAY,GAAG,GAAG,MAAM;AAC9E,MAAM,WAAW,YAAY,UAAU;AAEvC,MAAa,gBAAgB;CAC3B,MAAM;EAAE,QAAQ;EAAY,MAAM;EAAU,MAAM,gBAAgB,SAAS;CAAK;CAChF,OAAO;EAAE,QAAQ;EAAY,MAAM;EAAgB,MAAM;CAAe;CACxE,MAAM;EAAE,QAAQ;EAAY,MAAM;EAAU,MAAM,gBAAgB,SAAS;CAAM;AACnF"}

package/dist/asset-paths.mjs

@@ -0,0 +1,23 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+//#region src/asset-paths.ts
+/**
+* Locate a vendored file under `assets/` for the three layouts the app runs in:
+* - from source / the published library build, `assets/` sits next to the module;
+* - in the bundled Fly server (`dist/server.mjs`) it sits one level up
+*   (`/app/assets`, copied by the Dockerfile).
+* Throws with every path tried, since a missing file is a packaging bug.
+*/
+function findAsset(name, from, exists = existsSync) {
+	const candidates = [`assets/${name}`, `../assets/${name}`].map((relative) => fileURLToPath(new URL(relative, from)));
+	const found = candidates.find((path) => exists(path));
+	if (!found) throw new Error(`Vendored asset "${name}" not found. Looked in: ${candidates.join(", ")}`);
+	return found;
+}
+//#endregion
+export { findAsset };
+
+//# sourceMappingURL=asset-paths.mjs.map

package/dist/asset-paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-paths.mjs","names":[],"sources":["../src/asset-paths.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Locate a vendored file under `assets/` for the three layouts the app runs in:\n * - from source / the published library build, `assets/` sits next to the module;\n * - in the bundled Fly server (`dist/server.mjs`) it sits one level up\n *   (`/app/assets`, copied by the Dockerfile).\n * Throws with every path tried, since a missing file is a packaging bug.\n */\nexport function findAsset(\n  name: string,\n  from: string | URL,\n  exists: (path: string) => boolean = existsSync,\n): string {\n  const candidates = [`assets/${name}`, `../assets/${name}`].map((relative) =>\n    fileURLToPath(new URL(relative, from)),\n  );\n  const found = candidates.find((path) => exists(path));\n  if (!found) {\n    throw new Error(`Vendored asset \"${name}\" not found. Looked in: ${candidates.join(\", \")}`);\n  }\n  return found;\n}\n"],"mappings":";;;;;;;;;;;;;AAUA,SAAgB,UACd,MACA,MACA,SAAoC,YAC5B;CACR,MAAM,aAAa,CAAC,UAAU,QAAQ,aAAa,MAAM,CAAC,CAAC,KAAK,aAC9D,cAAc,IAAI,IAAI,UAAU,IAAI,CAAC,CACvC;CACA,MAAM,QAAQ,WAAW,MAAM,SAAS,OAAO,IAAI,CAAC;CACpD,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,mBAAmB,KAAK,0BAA0B,WAAW,KAAK,IAAI,GAAG;CAE3F,OAAO;AACT"}