@hediet/linkrpc-infra 0.0.1

package/dist/logging/index.js

@@ -0,0 +1,68 @@
+import { jsonDocumentEditSchema } from "../json-document/index.js";
+import { array, discriminatedUnion, enum as enum$1, lazy, literal, number, object, optional, record, string, unknown } from "zod/mini";
+import { defineInterface, requestType } from "@hediet/linkrpc";
+//#region src/logging/index.ts
+const logLevelSchema = enum$1([
+	"trace",
+	"debug",
+	"info",
+	"warn",
+	"error",
+	"off"
+]);
+const logErrorSchema = object({
+	name: optional(string()),
+	message: string(),
+	stack: optional(string())
+});
+const logEntrySchema = lazy(() => object({
+	timestamp: string(),
+	level: enum$1([
+		"trace",
+		"debug",
+		"info",
+		"warn",
+		"error"
+	]),
+	message: string(),
+	attributes: optional(record(string(), unknown())),
+	entries: optional(array(logEntrySchema)),
+	durationMs: optional(number()),
+	error: optional(logErrorSchema)
+}));
+const logDocumentSchema = object({
+	schemaVersion: literal(1),
+	service: string(),
+	startedAt: string(),
+	state: record(string(), unknown()),
+	entries: array(logEntrySchema)
+});
+const logStreamEventSchema = discriminatedUnion("type", [object({
+	type: literal("snapshot"),
+	revision: number(),
+	document: logDocumentSchema
+}), object({
+	type: literal("patch"),
+	revision: number(),
+	edits: array(jsonDocumentEditSchema)
+})]);
+/**
+* Standard structured-log protocol. Implementations choose their own storage,
+* retention, and sinks; this definition specifies only the LinkRPC wire API.
+*/
+const loggingInterface = defineInterface({
+	id: "linkrpc.logging",
+	description: "Structured service logs exposed as a revisioned JSON document stream. watchLog emits a snapshot first and then patches in revision order. Clients that observe a revision gap must resynchronize with getLogSnapshot."
+}, {
+	getLogLevel: requestType(object({}), object({ level: logLevelSchema })),
+	getLogSnapshot: requestType(object({}), object({
+		revision: number(),
+		document: logDocumentSchema
+	})),
+	setLogLevel: requestType(object({ level: logLevelSchema }), object({})),
+	watchLog: requestType(object({}), object({})).withStream({ server: logStreamEventSchema })
+});
+//#endregion
+export { logDocumentSchema, logEntrySchema, logLevelSchema, logStreamEventSchema, loggingInterface };
+
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["zEnum"],"sources":["../../src/logging/index.ts"],"sourcesContent":["import {\n    array,\n    discriminatedUnion,\n    enum as zEnum,\n    lazy,\n    literal,\n    number,\n    object,\n    optional,\n    record,\n    string,\n    unknown,\n} from 'zod/mini';\nimport type { output as zInfer } from 'zod/v4/core';\nimport { defineInterface, requestType, type Schema } from '@hediet/linkrpc';\nimport { jsonDocumentEditSchema } from '../json-document/index';\n\nexport const logLevelSchema = zEnum(['trace', 'debug', 'info', 'warn', 'error', 'off']);\nexport type LogLevel = zInfer<typeof logLevelSchema>;\nexport type EmittedLogLevel = Exclude<LogLevel, 'off'>;\n\nexport interface LogError {\n    readonly name?: string;\n    readonly message: string;\n    readonly stack?: string;\n}\n\nexport interface LogEntry {\n    readonly timestamp: string;\n    readonly level: EmittedLogLevel;\n    readonly message: string;\n    readonly attributes?: Readonly<Record<string, unknown>>;\n    readonly entries?: readonly LogEntry[];\n    readonly durationMs?: number;\n    readonly error?: LogError;\n}\n\nexport interface LogDocument {\n    readonly schemaVersion: 1;\n    readonly service: string;\n    readonly startedAt: string;\n    readonly state: Readonly<Record<string, unknown>>;\n    readonly entries: readonly LogEntry[];\n}\n\nconst logErrorSchema = object({\n    name: optional(string()),\n    message: string(),\n    stack: optional(string()),\n});\n\nexport const logEntrySchema: Schema<LogEntry> = lazy(() =>\n    object({\n        timestamp: string(),\n        level: zEnum(['trace', 'debug', 'info', 'warn', 'error']),\n        message: string(),\n        attributes: optional(record(string(), unknown())),\n        entries: optional(array(logEntrySchema)),\n        durationMs: optional(number()),\n        error: optional(logErrorSchema),\n    }),\n);\n\nexport const logDocumentSchema: Schema<LogDocument> = object({\n    schemaVersion: literal(1),\n    service: string(),\n    startedAt: string(),\n    state: record(string(), unknown()),\n    entries: array(logEntrySchema),\n});\n\nexport const logStreamEventSchema = discriminatedUnion('type', [\n    object({\n        type: literal('snapshot'),\n        revision: number(),\n        document: logDocumentSchema,\n    }),\n    object({\n        type: literal('patch'),\n        revision: number(),\n        edits: array(jsonDocumentEditSchema),\n    }),\n]);\n\nexport type LogStreamEvent = zInfer<typeof logStreamEventSchema>;\n\n/**\n * Standard structured-log protocol. Implementations choose their own storage,\n * retention, and sinks; this definition specifies only the LinkRPC wire API.\n */\nexport const loggingInterface = defineInterface(\n    {\n        id: 'linkrpc.logging',\n        description:\n            'Structured service logs exposed as a revisioned JSON document stream. '\n            + 'watchLog emits a snapshot first and then patches in revision order. '\n            + 'Clients that observe a revision gap must resynchronize with getLogSnapshot.',\n    },\n    {\n        getLogLevel: requestType(object({}), object({ level: logLevelSchema })),\n        getLogSnapshot: requestType(\n            object({}),\n            object({ revision: number(), document: logDocumentSchema }),\n        ),\n        setLogLevel: requestType(object({ level: logLevelSchema }), object({})),\n        watchLog: requestType(object({}), object({})).withStream({\n            server: logStreamEventSchema,\n        }),\n    },\n);\n"],"mappings":";;;;AAiBA,MAAa,iBAAiBA,OAAM;CAAC;CAAS;CAAS;CAAQ;CAAQ;CAAS;AAAK,CAAC;AA4BtF,MAAM,iBAAiB,OAAO;CAC1B,MAAM,SAAS,OAAO,CAAC;CACvB,SAAS,OAAO;CAChB,OAAO,SAAS,OAAO,CAAC;AAC5B,CAAC;AAED,MAAa,iBAAmC,WAC5C,OAAO;CACH,WAAW,OAAO;CAClB,OAAOA,OAAM;EAAC;EAAS;EAAS;EAAQ;EAAQ;CAAO,CAAC;CACxD,SAAS,OAAO;CAChB,YAAY,SAAS,OAAO,OAAO,GAAG,QAAQ,CAAC,CAAC;CAChD,SAAS,SAAS,MAAM,cAAc,CAAC;CACvC,YAAY,SAAS,OAAO,CAAC;CAC7B,OAAO,SAAS,cAAc;AAClC,CAAC,CACL;AAEA,MAAa,oBAAyC,OAAO;CACzD,eAAe,QAAQ,CAAC;CACxB,SAAS,OAAO;CAChB,WAAW,OAAO;CAClB,OAAO,OAAO,OAAO,GAAG,QAAQ,CAAC;CACjC,SAAS,MAAM,cAAc;AACjC,CAAC;AAED,MAAa,uBAAuB,mBAAmB,QAAQ,CAC3D,OAAO;CACH,MAAM,QAAQ,UAAU;CACxB,UAAU,OAAO;CACjB,UAAU;AACd,CAAC,GACD,OAAO;CACH,MAAM,QAAQ,OAAO;CACrB,UAAU,OAAO;CACjB,OAAO,MAAM,sBAAsB;AACvC,CAAC,CACL,CAAC;;;;;AAQD,MAAa,mBAAmB,gBAC5B;CACI,IAAI;CACJ,aACI;AAGR,GACA;CACI,aAAa,YAAY,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,eAAe,CAAC,CAAC;CACtE,gBAAgB,YACZ,OAAO,CAAC,CAAC,GACT,OAAO;EAAE,UAAU,OAAO;EAAG,UAAU;CAAkB,CAAC,CAC9D;CACA,aAAa,YAAY,OAAO,EAAE,OAAO,eAAe,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CACtE,UAAU,YAAY,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EACrD,QAAQ,qBACZ,CAAC;AACL,CACJ"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@hediet/linkrpc-infra",
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hediet/linkrpc.git",
+    "directory": "typescript/packages/linkrpc-infra"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./inspection": "./dist/inspection/index.js",
+    "./json-document": "./dist/json-document/index.js",
+    "./json-rpc": "./dist/json-rpc/index.js",
+    "./logging": "./dist/logging/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "zod": "^4.4.3",
+    "@hediet/linkrpc": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^3.0.0",
+    "vscode-json-languageserver": "1.3.4",
+    "zod": "^4.4.3",
+    "@hediet/linkrpc": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "test:interop": "vitest --run test/protocols/protocolInterop.live.test.ts",
+    "test:generated-interop": "vitest --run test/protocols/contracts/contracts.test.ts test/protocols/generatedInterop.crossLanguage.test.ts test/protocols/protocolInterop.live.test.ts",
+    "test:watch": "vitest"
+  }
+}