@isahaq/kosh-server 0.0.0-stage → 0.1.0

package/dist/telemetry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OpenTelemetry (CLAUDE.md, observability): one span per request (`HTTP GET /api/...`, with method, route, status and
+ * request id) and a child span around the Shutro transaction. `startTelemetry` installs the SDK when an exporter is
+ * configured (OTLP over HTTP via `OTEL_EXPORTER_OTLP_ENDPOINT`, or span processors passed in, e.g. in tests).
+ */
+import { type Span, trace } from '@opentelemetry/api';
+import { tracing } from '@opentelemetry/sdk-node';
+/** The tracer Kosh's spans come from. */
+export declare const tracer: ReturnType<typeof trace.getTracer>;
+/** A started telemetry SDK. */
+export interface Telemetry {
+    shutdown(): Promise<void>;
+}
+/**
+ * Starts the OpenTelemetry SDK when there is somewhere to send spans; otherwise does nothing (the API is a no-op).
+ */
+export declare function startTelemetry(options?: {
+    readonly serviceName?: string;
+    readonly spanProcessors?: readonly tracing.SpanProcessor[];
+}): Telemetry;
+/** Ends a request span with its status. */
+export declare function endSpan(span: Span, status: number, error?: unknown): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,IAAI,EAAkB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAW,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE3D,yCAAyC;AACzC,eAAO,MAAM,MAAM,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,CAA2C,CAAC;AAElG,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE;IACP,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,OAAO,CAAC,aAAa,EAAE,CAAC;CACvD,GACL,SAAS,CAaX;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAMzE"}

package/dist/telemetry.js

@@ -0,0 +1,38 @@
+/**
+ * OpenTelemetry (CLAUDE.md, observability): one span per request (`HTTP GET /api/...`, with method, route, status and
+ * request id) and a child span around the Shutro transaction. `startTelemetry` installs the SDK when an exporter is
+ * configured (OTLP over HTTP via `OTEL_EXPORTER_OTLP_ENDPOINT`, or span processors passed in, e.g. in tests).
+ */
+import { SpanStatusCode, trace } from '@opentelemetry/api';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { NodeSDK, tracing } from '@opentelemetry/sdk-node';
+/** The tracer Kosh's spans come from. */
+export const tracer = trace.getTracer('kosh-server', '0.1.0');
+/**
+ * Starts the OpenTelemetry SDK when there is somewhere to send spans; otherwise does nothing (the API is a no-op).
+ */
+export function startTelemetry(options = {}) {
+    const endpoint = process.env['OTEL_EXPORTER_OTLP_ENDPOINT'];
+    const processors = [
+        ...(options.spanProcessors ?? []),
+        ...(endpoint === undefined ? [] : [new tracing.BatchSpanProcessor(new OTLPTraceExporter())]),
+    ];
+    if (processors.length === 0)
+        return { shutdown: async () => { } };
+    const sdk = new NodeSDK({
+        serviceName: options.serviceName ?? 'kosh',
+        spanProcessors: processors,
+    });
+    sdk.start();
+    return { shutdown: () => sdk.shutdown() };
+}
+/** Ends a request span with its status. */
+export function endSpan(span, status, error) {
+    span.setAttribute('http.response.status_code', status);
+    if (error !== undefined)
+        span.recordException(error instanceof Error ? error : new Error(String(error)));
+    if (status >= 500)
+        span.setStatus({ code: SpanStatusCode.ERROR });
+    span.end();
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAa,cAAc,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE3D,yCAAyC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAuC,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAOlG;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAO,GAGH,EAAE;IAEN,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACjC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC,CAAC;KAC7F,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM;QAC1C,cAAc,EAAE,UAAU;KAC3B,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,MAAc,EAAE,KAAe;IACjE,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,SAAS;QACrB,IAAI,CAAC,eAAe,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClF,IAAI,MAAM,IAAI,GAAG;QAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,EAAE,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@isahaq/kosh-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Fastify app, module loader, REST/OpenAPI generator, auth, Shutro environment per request (RFC 0002)",
+  "keywords": [
+    "kosh",
+    "erp",
+    "typescript",
+    "postgresql",
+    "shutro"
+  ],
+  "author": "Isahaq <hmisahaq01@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/isahaq1/kosh/tree/main/packages/server#readme",
+  "bugs": {
+    "url": "https://github.com/isahaq1/kosh/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isahaq1/kosh.git",
+    "directory": "packages/server"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "@kosh/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./orm": {
+      "@kosh/source": "./src/orm.ts",
+      "types": "./dist/orm.d.ts",
+      "default": "./dist/orm.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fastify/rate-limit": "^11.2.1",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.223.0",
+    "@opentelemetry/sdk-node": "^0.223.0",
+    "fastify": "^5.12.7",
+    "iovalkey": "^0.4.0",
+    "shutro": "^0.2.0",
+    "@isahaq/kosh-modules-sdk": "0.1.0",
+    "@isahaq/kosh-views": "0.1.0"
+  },
+  "devDependencies": {
+    "@testcontainers/postgresql": "^12.2.1",
+    "testcontainers": "^12.2.1",
+    "@isahaq/kosh-search": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }