@clawnify/app 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { DiscoveryOptions, OpenAPIHono } from '@clawnify/routes';
+export { DiscoverableApp, DiscoveryOptions, OpenAPIHono, createRoute, describeRoutes, mountDiscovery, z } from '@clawnify/routes';
+import { Env } from 'hono';
+
+/**
+ * @clawnify/app — the standard Clawnify app skeleton in one call.
+ *
+ * `createApp(opts)` returns a fully-wired OpenAPIHono with every always-required,
+ * cross-cutting concern pre-baked, so an app's server file is just imports +
+ * routes + `export default app`:
+ *
+ *   import { createApp, createRoute, z } from "@clawnify/app";
+ *   const app = createApp<Env>({ title: "CRM App", version: "1.0.0" });
+ *   app.openapi(listContacts, handler);
+ *   export default app;
+ *
+ * What it bakes in — the boilerplate every app used to re-write in its server
+ * file, and could forget:
+ *   • OpenAPIHono construction (typed to your Env).
+ *   • Database init — `initDB(c.env)` middleware on every request. @clawnify/db
+ *     auto-detects the D1 binding (production WfP) or the Storage capability
+ *     binding (Dynamic Workers preview), so handlers can query immediately.
+ *   • API discovery — `mountDiscovery` serves GET /api/openapi.json (the machine
+ *     contract) and GET /llms.txt (the lean agent index), generated from the
+ *     live routes so they can't drift.
+ *
+ * The point: a new always-required concern is added HERE once and every app
+ * inherits it on the next rebuild — instead of a line each agent must remember
+ * to write (and a build gate to enforce) in every app.
+ */
+
+interface CreateAppOptions extends DiscoveryOptions {
+    /**
+     * Wire the per-request database middleware (`initDB(c.env)` on `*`). Default
+     * true — every Clawnify app has a D1 / Storage binding. Set false only for the
+     * rare app with no database.
+     */
+    db?: boolean;
+    /**
+     * Mount GET /api/openapi.json + GET /llms.txt discovery. Default true. Set
+     * false only if the app deliberately opts out of API discovery.
+     */
+    discovery?: boolean;
+}
+/**
+ * Create a fully-wired Clawnify app.
+ *
+ * `E` is your Hono env — `{ Bindings: { DB: D1Database, ... } }` — pass it so
+ * route handlers get a typed `c.env`. Everything after this call is your app's
+ * own routes and business logic:
+ *
+ *   const app = createApp<Env>({ title: "CRM App", version: "1.0.0" });
+ *   app.openapi(route, handler);
+ *   export default app;
+ */
+declare function createApp<E extends Env = Env>(opts?: CreateAppOptions): OpenAPIHono<E>;
+
+export { type CreateAppOptions, createApp };

package/dist/index.js

@@ -0,0 +1,32 @@
+// src/index.ts
+import { OpenAPIHono, mountDiscovery } from "@clawnify/routes";
+import { initDB } from "@clawnify/db";
+import {
+  OpenAPIHono as OpenAPIHono2,
+  createRoute,
+  z,
+  mountDiscovery as mountDiscovery2,
+  describeRoutes
+} from "@clawnify/routes";
+function createApp(opts = {}) {
+  const app = new OpenAPIHono();
+  if (opts.db !== false) {
+    app.use("*", async (c, next) => {
+      initDB(c.env);
+      await next();
+    });
+  }
+  if (opts.discovery !== false) {
+    mountDiscovery(app, opts);
+  }
+  return app;
+}
+export {
+  OpenAPIHono2 as OpenAPIHono,
+  createApp,
+  createRoute,
+  describeRoutes,
+  mountDiscovery2 as mountDiscovery,
+  z
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @clawnify/app — the standard Clawnify app skeleton in one call.\n *\n * `createApp(opts)` returns a fully-wired OpenAPIHono with every always-required,\n * cross-cutting concern pre-baked, so an app's server file is just imports +\n * routes + `export default app`:\n *\n *   import { createApp, createRoute, z } from \"@clawnify/app\";\n *   const app = createApp<Env>({ title: \"CRM App\", version: \"1.0.0\" });\n *   app.openapi(listContacts, handler);\n *   export default app;\n *\n * What it bakes in — the boilerplate every app used to re-write in its server\n * file, and could forget:\n *   • OpenAPIHono construction (typed to your Env).\n *   • Database init — `initDB(c.env)` middleware on every request. @clawnify/db\n *     auto-detects the D1 binding (production WfP) or the Storage capability\n *     binding (Dynamic Workers preview), so handlers can query immediately.\n *   • API discovery — `mountDiscovery` serves GET /api/openapi.json (the machine\n *     contract) and GET /llms.txt (the lean agent index), generated from the\n *     live routes so they can't drift.\n *\n * The point: a new always-required concern is added HERE once and every app\n * inherits it on the next rebuild — instead of a line each agent must remember\n * to write (and a build gate to enforce) in every app.\n */\nimport { OpenAPIHono, mountDiscovery, type DiscoveryOptions } from \"@clawnify/routes\";\nimport { initDB } from \"@clawnify/db\";\nimport type { Env } from \"hono\";\n\n// One routing import for app authors: everything needed to declare routes and\n// build the app comes from @clawnify/app. These are re-exports of the same\n// @hono/zod-openapi primitives @clawnify/routes exposes — never reimplemented —\n// so route creation, discovery, and construction all live behind one import.\nexport {\n  OpenAPIHono,\n  createRoute,\n  z,\n  mountDiscovery,\n  describeRoutes,\n} from \"@clawnify/routes\";\nexport type { DiscoveryOptions, DiscoverableApp } from \"@clawnify/routes\";\n\nexport interface CreateAppOptions extends DiscoveryOptions {\n  /**\n   * Wire the per-request database middleware (`initDB(c.env)` on `*`). Default\n   * true — every Clawnify app has a D1 / Storage binding. Set false only for the\n   * rare app with no database.\n   */\n  db?: boolean;\n  /**\n   * Mount GET /api/openapi.json + GET /llms.txt discovery. Default true. Set\n   * false only if the app deliberately opts out of API discovery.\n   */\n  discovery?: boolean;\n}\n\n/**\n * Create a fully-wired Clawnify app.\n *\n * `E` is your Hono env — `{ Bindings: { DB: D1Database, ... } }` — pass it so\n * route handlers get a typed `c.env`. Everything after this call is your app's\n * own routes and business logic:\n *\n *   const app = createApp<Env>({ title: \"CRM App\", version: \"1.0.0\" });\n *   app.openapi(route, handler);\n *   export default app;\n */\nexport function createApp<E extends Env = Env>(\n  opts: CreateAppOptions = {},\n): OpenAPIHono<E> {\n  const app = new OpenAPIHono<E>();\n\n  if (opts.db !== false) {\n    app.use(\"*\", async (c, next) => {\n      // @clawnify/db reads the DB (D1) or Storage binding off the env and caches\n      // the Drizzle client for this request. Safe to call on every request.\n      initDB(c.env as unknown as Parameters<typeof initDB>[0]);\n      await next();\n    });\n  }\n\n  if (opts.discovery !== false) {\n    mountDiscovery(app, opts);\n  }\n\n  return app;\n}\n"],"mappings":";AA0BA,SAAS,aAAa,sBAA6C;AACnE,SAAS,cAAc;AAOvB;AAAA,EACE,eAAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAAC;AAAA,EACA;AAAA,OACK;AA4BA,SAAS,UACd,OAAyB,CAAC,GACV;AAChB,QAAM,MAAM,IAAI,YAAe;AAE/B,MAAI,KAAK,OAAO,OAAO;AACrB,QAAI,IAAI,KAAK,OAAO,GAAG,SAAS;AAG9B,aAAO,EAAE,GAA8C;AACvD,YAAM,KAAK;AAAA,IACb,CAAC;AAAA,EACH;AAEA,MAAI,KAAK,cAAc,OAAO;AAC5B,mBAAe,KAAK,IAAI;AAAA,EAC1B;AAEA,SAAO;AACT;","names":["OpenAPIHono","mountDiscovery"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@clawnify/app",
+  "version": "0.1.0",
+  "description": "The standard Clawnify app skeleton in one call. createApp() returns a fully-wired OpenAPIHono with D1/Storage init + /api/openapi.json + /llms.txt discovery pre-baked, so an app is just imports + routes + export.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clawnify/db": "^0.4.1",
+    "@clawnify/routes": "^0.2.1"
+  },
+  "peerDependencies": {
+    "@hono/zod-openapi": ">=0.18 <1",
+    "hono": "*"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260405.1",
+    "@hono/zod-openapi": "^0.18.0",
+    "hono": "^4.6.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}