@kivia/sdk 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # Kivia TypeScript SDK
 
-The Kivia TypeScript SDK is the official Node.js client for the Kivia observability platform. It allows Node.js developers using Express or Fastify to instantly track API request metrics, response times, and paths.
+The Kivia TypeScript SDK is the official Node.js client for the Kivia observability platform. It allows Node.js developers using Express, Fastify, or Hono to instantly track API request metrics, response times, and paths.
 
 ## Installation
 
@@ -76,3 +76,22 @@ fastify.get('/hello', async (request, reply) => {
 
 fastify.listen({ port: 3000 });
 ```
+
+## Quick Start (with Hono)
+
+```typescript
+import { Hono } from 'hono';
+import { kiviaHonoMiddleware } from '@kivia/sdk';
+
+const app = new Hono();
+
+app.use('*', kiviaHonoMiddleware({
+  apiKey: 'YOUR_KIVIA_API_KEY',
+}));
+
+app.get('/hello', (c) => {
+  return c.json({ message: 'Hello from Kivia TS SDK using Hono!' });
+});
+
+export default app;
+```

package/dist/client.d.ts

@@ -12,6 +12,12 @@ export declare class KiviaClient {
      * Usage: fastify.addHook('onResponse', kiviaClient.logFastifyOnResponse());
      */
     logFastifyOnResponse(): (request: any, reply: any) => Promise<void>;
+    /**
+     * Hono middleware for automatically logging requests.
+     *
+     * Usage with Hono:
+     *   app.use('*', kiviaClient.logHono());
+     */
+    logHono(): (c: any, next: any) => Promise<void>;
     private sendLog;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -47,6 +47,31 @@ class KiviaClient {
             this.sendLog(logEntry);
         };
     }
+    /**
+     * Hono middleware for automatically logging requests.
+     *
+     * Usage with Hono:
+     *   app.use('*', kiviaClient.logHono());
+     */
+    logHono() {
+        return async (c, next) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const start = Date.now();
+            await next();
+            const latency = Date.now() - start;
+            const logEntry = {
+                path: c.req.path || c.req.url,
+                status: c.res.status,
+                ip_address: ((_b = (_a = c.req).header) === null || _b === void 0 ? void 0 : _b.call(_a, 'x-forwarded-for')) ||
+                    ((_d = (_c = c.req).header) === null || _d === void 0 ? void 0 : _d.call(_c, 'x-real-ip')) ||
+                    ((_f = (_e = c.req.raw) === null || _e === void 0 ? void 0 : _e.headers) === null || _f === void 0 ? void 0 : _f['x-forwarded-for']) ||
+                    ((_h = (_g = c.req.raw) === null || _g === void 0 ? void 0 : _g.socket) === null || _h === void 0 ? void 0 : _h.remoteAddress),
+                timestamp: new Date().toISOString(),
+                latency,
+            };
+            this.sendLog(logEntry);
+        };
+    }
     async sendLog(logEntry) {
         try {
             const response = await fetch(`${this.baseUrl}/logs/create`, {
@@ -68,4 +93,3 @@ class KiviaClient {
     }
 }
 exports.KiviaClient = KiviaClient;
-//# sourceMappingURL=client.js.map

package/dist/fastify.d.ts

@@ -4,4 +4,3 @@ import { KiviaClientOptions } from './types';
  * Usage: fastify.register(kiviaFastifyPlugin, { apiKey: '...' })
  */
 export declare function kiviaFastifyPlugin(fastify: any, options: KiviaClientOptions): Promise<void>;
-//# sourceMappingURL=fastify.d.ts.map

package/dist/fastify.js

@@ -10,4 +10,3 @@ async function kiviaFastifyPlugin(fastify, options) {
     const client = new client_1.KiviaClient(options);
     fastify.addHook('onResponse', client.logFastifyOnResponse());
 }
-//# sourceMappingURL=fastify.js.map

package/dist/hono.d.ts

@@ -0,0 +1,12 @@
+import { KiviaClientOptions } from './types';
+/**
+ * Hono middleware factory for Kivia observability.
+ *
+ * Usage:
+ *   import { Hono } from 'hono';
+ *   import { kiviaHonoMiddleware } from '@kivia/sdk';
+ *
+ *   const app = new Hono();
+ *   app.use('*', kiviaHonoMiddleware({ apiKey: 'YOUR_KIVIA_API_KEY' }));
+ */
+export declare function kiviaHonoMiddleware(options: KiviaClientOptions): (c: any, next: any) => Promise<void>;

package/dist/hono.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kiviaHonoMiddleware = kiviaHonoMiddleware;
+const client_1 = require("./client");
+/**
+ * Hono middleware factory for Kivia observability.
+ *
+ * Usage:
+ *   import { Hono } from 'hono';
+ *   import { kiviaHonoMiddleware } from '@kivia/sdk';
+ *
+ *   const app = new Hono();
+ *   app.use('*', kiviaHonoMiddleware({ apiKey: 'YOUR_KIVIA_API_KEY' }));
+ */
+function kiviaHonoMiddleware(options) {
+    const client = new client_1.KiviaClient(options);
+    return client.logHono();
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from './types';
 export * from './client';
 export * from './fastify';
-//# sourceMappingURL=index.d.ts.map
+export * from './hono';

package/dist/index.js

@@ -17,4 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
 __exportStar(require("./client"), exports);
 __exportStar(require("./fastify"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./hono"), exports);

package/dist/types.d.ts

@@ -13,4 +13,3 @@ export interface KiviaClientOptions {
      */
     baseUrl?: string;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/package.json

@@ -27,5 +27,5 @@
     "@types/node": "^25.5.2",
     "typescript": "^5.4.0"
   },
-  "version": "0.1.1"
+  "version": "0.1.2"
 }

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAO,MAAM,SAAS,CAAC;AAElD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,kBAAkB;IAKvC;;OAEG;IACI,aAAa,KACV,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG;IAsBvC;;;OAGG;IACI,oBAAoB,KACX,SAAS,GAAG,EAAE,OAAO,GAAG;YAgB1B,OAAO;CAmBtB"}

package/dist/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IAItB,YAAY,OAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,qDAAqD,CAAC;IAC1F,CAAC;IAED;;OAEG;IACI,aAAa;QAClB,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEzB,oCAAoC;YACpC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;;gBACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBAEnC,MAAM,QAAQ,GAAQ;oBACpB,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG;oBAChC,MAAM,EAAE,GAAG,CAAC,UAAU;oBACtB,UAAU,EAAE,GAAG,CAAC,EAAE,KAAI,MAAA,GAAG,CAAC,UAAU,0CAAE,aAAa,CAAA;oBACnD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,OAAO;iBACR,CAAC;gBAEF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YAEH,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,oBAAoB;QACzB,OAAO,KAAK,EAAE,OAAY,EAAE,KAAU,EAAE,EAAE;;YACxC,uEAAuE;YACvE,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAEpE,MAAM,QAAQ,GAAQ;gBACpB,IAAI,EAAE,OAAO,CAAC,GAAG,KAAI,MAAA,OAAO,CAAC,GAAG,0CAAE,GAAG,CAAA;gBACrC,MAAM,EAAE,KAAK,CAAC,UAAU,KAAI,MAAA,KAAK,CAAC,GAAG,0CAAE,UAAU,CAAA;gBACjD,UAAU,EAAE,OAAO,CAAC,EAAE,KAAI,MAAA,MAAA,OAAO,CAAC,GAAG,0CAAE,UAAU,0CAAE,aAAa,CAAA;gBAChE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;aAC7B,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,QAAa;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,cAAc,EAAE;gBAC1D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,iBAAiB,EAAE,IAAI,CAAC,MAAM;iBAC/B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;aAC/B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AA3ED,kCA2EC"}

package/dist/fastify.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,kBAAkB,iBAGjF"}

package/dist/fastify.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":";;AAOA,gDAGC;AAVD,qCAAuC;AAGvC;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CAAC,OAAY,EAAE,OAA2B;IAChF,MAAM,MAAM,GAAG,IAAI,oBAAW,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B"}

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}