@unifyplane/logsdk 0.1.7 → 0.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/core/record_builder.d.ts +2 -2
- package/dist/core/record_builder.d.ts.map +1 -1
- package/dist/core/record_builder.js +9 -5
- package/dist/core/record_builder.js.map +1 -1
- package/dist/core/types.d.ts +2 -1
- package/dist/core/types.d.ts.map +1 -1
- package/dist/index.d.ts +8 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +35 -11
- package/dist/index.js.map +1 -1
- package/dist/validate/api_surface_guard.d.ts.map +1 -1
- package/dist/validate/api_surface_guard.js +2 -2
- package/dist/validate/api_surface_guard.js.map +1 -1
- package/dist/validate/schema_guard.d.ts.map +1 -1
- package/dist/validate/schema_guard.js +1 -0
- package/dist/validate/schema_guard.js.map +1 -1
- package/package.json +2 -6
- package/src/core/record_builder.ts +10 -6
- package/src/core/types.ts +2 -1
- package/src/index.ts +61 -19
- package/src/validate/api_surface_guard.ts +3 -2
- package/src/validate/schema_guard.ts +1 -0
- package/unifyplane-logsdk-0.1.9.tgz +0 -0
- package/unifyplane-logsdk-0.1.2.tgz +0 -0
|
@@ -11,7 +11,7 @@ export type SystemOwnership = {
|
|
|
11
11
|
system_type: string;
|
|
12
12
|
environment: string;
|
|
13
13
|
system_version: string;
|
|
14
|
-
instance_id
|
|
14
|
+
instance_id: string;
|
|
15
15
|
};
|
|
16
16
|
export type StepRecordOverrides = {
|
|
17
17
|
record_id?: string;
|
|
@@ -30,5 +30,5 @@ export type StepRecordOverrides = {
|
|
|
30
30
|
source_function?: string;
|
|
31
31
|
source_line?: number;
|
|
32
32
|
};
|
|
33
|
-
export declare function buildStepRecord(message: string, sequence: number, system: SystemOwnership, overrides?: StepRecordOverrides): StepRecord;
|
|
33
|
+
export declare function buildStepRecord(step_id: string, message: string, sequence: number, system: SystemOwnership, overrides?: StepRecordOverrides): StepRecord;
|
|
34
34
|
//# sourceMappingURL=record_builder.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"record_builder.d.ts","sourceRoot":"","sources":["../../src/core/record_builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,
|
|
1
|
+
{"version":3,"file":"record_builder.d.ts","sourceRoot":"","sources":["../../src/core/record_builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,mBAAwB,GAClC,UAAU,CA2DZ"}
|
|
@@ -9,7 +9,10 @@ export const message_constraints = {
|
|
|
9
9
|
maxLength: MESSAGE_MAX_LENGTH,
|
|
10
10
|
validate: assertValidMessage,
|
|
11
11
|
};
|
|
12
|
-
export function buildStepRecord(message, sequence, system, overrides = {}) {
|
|
12
|
+
export function buildStepRecord(step_id, message, sequence, system, overrides = {}) {
|
|
13
|
+
if (typeof step_id !== "string" || step_id.trim().length === 0) {
|
|
14
|
+
throw new Error("step_id must be a non-empty string");
|
|
15
|
+
}
|
|
13
16
|
const validatedMessage = message_constraints.validate(message);
|
|
14
17
|
validateSequence(sequence);
|
|
15
18
|
validateSystemOwnership(system);
|
|
@@ -21,6 +24,7 @@ export function buildStepRecord(message, sequence, system, overrides = {}) {
|
|
|
21
24
|
const baseRecord = {
|
|
22
25
|
record_version: RECORD_VERSION,
|
|
23
26
|
record_id: recordId,
|
|
27
|
+
step_id,
|
|
24
28
|
sequence,
|
|
25
29
|
timestamp_utc: timestampUtc,
|
|
26
30
|
monotonic_time: monotonicTime,
|
|
@@ -29,11 +33,12 @@ export function buildStepRecord(message, sequence, system, overrides = {}) {
|
|
|
29
33
|
system_type: system.system_type,
|
|
30
34
|
environment: system.environment,
|
|
31
35
|
system_version: system.system_version,
|
|
36
|
+
instance_id: system.instance_id,
|
|
32
37
|
message: validatedMessage,
|
|
33
38
|
context_hash: contextHash,
|
|
34
39
|
context_version: contextVersion,
|
|
35
40
|
};
|
|
36
|
-
|
|
41
|
+
baseRecord.instance_id = system.instance_id;
|
|
37
42
|
setOptionalField(baseRecord, "trace_id", overrides.trace_id);
|
|
38
43
|
setOptionalField(baseRecord, "span_id", overrides.span_id);
|
|
39
44
|
setOptionalField(baseRecord, "parent_step_id", overrides.parent_step_id);
|
|
@@ -67,6 +72,7 @@ function validateSystemOwnership(system) {
|
|
|
67
72
|
"system_type",
|
|
68
73
|
"environment",
|
|
69
74
|
"system_version",
|
|
75
|
+
"instance_id",
|
|
70
76
|
];
|
|
71
77
|
for (const field of requiredFields) {
|
|
72
78
|
const value = system[field];
|
|
@@ -74,9 +80,6 @@ function validateSystemOwnership(system) {
|
|
|
74
80
|
throw new Error(`Missing required system field: ${field}`);
|
|
75
81
|
}
|
|
76
82
|
}
|
|
77
|
-
if (system.instance_id !== undefined && typeof system.instance_id !== "string") {
|
|
78
|
-
throw new Error("instance_id must be a string when provided");
|
|
79
|
-
}
|
|
80
83
|
}
|
|
81
84
|
function createRecordId() {
|
|
82
85
|
return typeof randomUUID === "function"
|
|
@@ -160,6 +163,7 @@ function setOptionalField(record, key, value) {
|
|
|
160
163
|
const HASH_FIELD_ORDER = [
|
|
161
164
|
"record_version",
|
|
162
165
|
"record_id",
|
|
166
|
+
"step_id",
|
|
163
167
|
"sequence",
|
|
164
168
|
"timestamp_utc",
|
|
165
169
|
"monotonic_time",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"record_builder.js","sourceRoot":"","sources":["../../src/core/record_builder.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAa,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,MAAM,cAAc,GAAG,aAAa,CAAC;AACrC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,kBAAkB;IAC7B,QAAQ,EAAE,kBAAkB;CAC7B,CAAC;AA+BF,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,QAAgB,EAChB,MAAuB,EACvB,YAAiC,EAAE;IAEnC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/D,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzE,MAAM,aAAa,GAAG,SAAS,CAAC,cAAc,IAAI,YAAY,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAuD;QACrE,cAAc,EAAE,cAAc;QAC9B,SAAS,EAAE,QAAQ;QACnB,QAAQ;QACR,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,OAAO,EAAE,gBAAgB;QACzB,YAAY,EAAE,WAAW;QACzB,eAAe,EAAE,cAAc;KAChC,CAAC;IAEF,
|
|
1
|
+
{"version":3,"file":"record_builder.js","sourceRoot":"","sources":["../../src/core/record_builder.ts"],"names":[],"mappings":"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"}
|
package/dist/core/types.d.ts
CHANGED
|
@@ -3,6 +3,7 @@ export type FanoutOutcome = "OK" | "DEGRADED" | "FAILED";
|
|
|
3
3
|
export interface StepRecord {
|
|
4
4
|
record_version: "log.step.v1";
|
|
5
5
|
record_id: string;
|
|
6
|
+
step_id: string;
|
|
6
7
|
sequence: number;
|
|
7
8
|
timestamp_utc: string;
|
|
8
9
|
monotonic_time: number;
|
|
@@ -11,7 +12,7 @@ export interface StepRecord {
|
|
|
11
12
|
system_type: string;
|
|
12
13
|
environment: string;
|
|
13
14
|
system_version: string;
|
|
14
|
-
instance_id
|
|
15
|
+
instance_id: string;
|
|
15
16
|
trace_id?: string;
|
|
16
17
|
span_id?: string;
|
|
17
18
|
parent_step_id?: string;
|
package/dist/core/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IAEzB,cAAc,EAAE,aAAa,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IAGjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IAEzB,cAAc,EAAE,aAAa,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IAGjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IAGxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAGzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB"}
|
package/dist/index.d.ts
CHANGED
|
@@ -20,14 +20,18 @@ export type LogSDKConfig = {
|
|
|
20
20
|
*/
|
|
21
21
|
mode?: "authoritative" | "non-authoritative";
|
|
22
22
|
};
|
|
23
|
+
/**
|
|
24
|
+
* LogApi v1.0: step(step_id: string, message?: string)
|
|
25
|
+
* - step_id: REQUIRED, kebab-case, no spaces, no uppercase, no punctuation (except dash/underscore)
|
|
26
|
+
* - message: OPTIONAL, human-readable, defaults to step_id if omitted
|
|
27
|
+
*/
|
|
23
28
|
export type LogApi = {
|
|
24
|
-
step(
|
|
29
|
+
step(step_id: string, message?: string): Promise<void>;
|
|
25
30
|
flush?: () => Promise<void>;
|
|
26
31
|
};
|
|
27
32
|
export type { SystemOwnership };
|
|
28
33
|
export declare function initLogSDK(config: LogSDKConfig): LogApi;
|
|
29
34
|
export declare function createLogger(config: LogSDKConfig): LogApi;
|
|
30
|
-
export {
|
|
31
|
-
export {
|
|
32
|
-
export { StdoutSink, FileNdjsonSink } from "./sinks/index.js";
|
|
35
|
+
export { createFileNdjsonSink } from "./sinks/file_ndjson_sink.js";
|
|
36
|
+
export { createStdoutSink } from "./sinks/stdout_sink.js";
|
|
33
37
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;CAC9C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA4FvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AASD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -5,26 +5,46 @@ import { assertValidMessage } from "./core/message_constraints.js";
|
|
|
5
5
|
import { fanout } from "./core/fanout.js";
|
|
6
6
|
import { assertApiSurface } from "./validate/api_surface_guard.js";
|
|
7
7
|
import { assertStepRecord } from "./validate/schema_guard.js";
|
|
8
|
-
import { AUTHORITATIVE_FAILURE_SWALLOWED,
|
|
8
|
+
import { AUTHORITATIVE_FAILURE_SWALLOWED, PAYLOAD_EMBEDDING_VIOLATION, NonComplianceError, } from "./validate/noncompliance.js";
|
|
9
9
|
export function initLogSDK(config) {
|
|
10
10
|
initContext(config.context);
|
|
11
11
|
const idGenerator = createIdGenerator(config.system.instance_id);
|
|
12
12
|
const sinks = [...config.sinks];
|
|
13
|
+
// --- v1.0 API: step(step_id, message?) ---
|
|
13
14
|
const api = {
|
|
14
|
-
async step(message) {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
async step(step_id, message) {
|
|
16
|
+
// Validate step_id
|
|
17
|
+
if (typeof step_id !== "string" || step_id.length === 0) {
|
|
18
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "step_id must be a non-empty string.");
|
|
19
|
+
}
|
|
20
|
+
if (step_id.includes(" ")) {
|
|
21
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "step_id must not contain spaces.");
|
|
22
|
+
}
|
|
23
|
+
if (/[A-Z]/.test(step_id)) {
|
|
24
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "step_id must not contain uppercase letters.");
|
|
25
|
+
}
|
|
26
|
+
if (/[:.,;!?"'`]/.test(step_id)) {
|
|
27
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "step_id must not contain punctuation except dash/underscore.");
|
|
28
|
+
}
|
|
29
|
+
// message: optional, defaults to step_id
|
|
30
|
+
let stepMessage;
|
|
31
|
+
if (message === undefined) {
|
|
32
|
+
stepMessage = step_id;
|
|
33
|
+
}
|
|
34
|
+
else {
|
|
35
|
+
if (typeof message !== "string") {
|
|
36
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "Message must be a string.");
|
|
18
37
|
}
|
|
19
|
-
|
|
38
|
+
stepMessage = message;
|
|
20
39
|
}
|
|
40
|
+
// Validate message using existing constraints
|
|
21
41
|
try {
|
|
22
|
-
assertValidMessage(
|
|
42
|
+
assertValidMessage(stepMessage);
|
|
23
43
|
}
|
|
24
44
|
catch (error) {
|
|
25
|
-
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message
|
|
45
|
+
throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message.");
|
|
26
46
|
}
|
|
27
|
-
const record = buildStepRecord(
|
|
47
|
+
const record = buildStepRecord(step_id, stepMessage, idGenerator.nextSequence(), config.system, {
|
|
28
48
|
record_id: idGenerator.nextRecordId(),
|
|
29
49
|
});
|
|
30
50
|
assertStepRecord(record);
|
|
@@ -49,6 +69,10 @@ export function initLogSDK(config) {
|
|
|
49
69
|
export function createLogger(config) {
|
|
50
70
|
return initLogSDK(config);
|
|
51
71
|
}
|
|
52
|
-
export { fileNdjsonSink } from "./sinks/file_ndjson.js";
|
|
53
|
-
export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
|
|
72
|
+
// export { fileNdjsonSink } from "./sinks/file_ndjson.js";
|
|
73
|
+
// export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
|
|
74
|
+
// ---- Execution sinks (public API) ----
|
|
75
|
+
// export { StdoutSink, FileNdjsonSink } from "./sinks/index.js"; -- Delete
|
|
76
|
+
export { createFileNdjsonSink } from "./sinks/file_ndjson_sink.js";
|
|
77
|
+
export { createStdoutSink } from "./sinks/stdout_sink.js";
|
|
54
78
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,+BAA+B,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api_surface_guard.d.ts","sourceRoot":"","sources":["../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"AA2DA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"api_surface_guard.d.ts","sourceRoot":"","sources":["../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"AA2DA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+CvD"}
|
|
@@ -44,9 +44,9 @@ export function assertApiSurface(surface) {
|
|
|
44
44
|
}
|
|
45
45
|
}
|
|
46
46
|
if (!("step" in api)) {
|
|
47
|
-
throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must expose step(message).");
|
|
47
|
+
throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must expose step(step_id, message?).");
|
|
48
48
|
}
|
|
49
|
-
assertFunction(api.step, "step",
|
|
49
|
+
assertFunction(api.step, "step", 2);
|
|
50
50
|
if ("flush" in api) {
|
|
51
51
|
assertFunction(api.flush, "flush", 0);
|
|
52
52
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api_surface_guard.js","sourceRoot":"","sources":["../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,CAAU,CAAC;AAIhE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,aAAa;IACb,KAAK;IACL,MAAM;IACN,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,KAAc,EAAE,IAAY,EAAE,KAAa;IACjE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,GAAG,IAAI,sBAAsB,CAC9B,CAAC;IACJ,CAAC;IAED,IAAK,KAAkB,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,GAAG,IAAI,wBAAwB,KAAK,eAAe,CACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,SAAS,GAAG,KAAoC,CAAC;IACvD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;IAE9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,8BAA8B,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,OAAkC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,EACrB,kCAAkC,GAAG,GAAG,CACzC,CAAC;QACJ,CAAC;IACH,CAAC;
|
|
1
|
+
{"version":3,"file":"api_surface_guard.js","sourceRoot":"","sources":["../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema_guard.d.ts","sourceRoot":"","sources":["../../src/validate/schema_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"schema_guard.d.ts","sourceRoot":"","sources":["../../src/validate/schema_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA2DxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CA8G9E;AAID,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,IAAI,CAWN"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema_guard.js","sourceRoot":"","sources":["../../src/validate/schema_guard.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"schema_guard.js","sourceRoot":"","sources":["../../src/validate/schema_guard.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,18 +1,14 @@
|
|
|
1
|
+
|
|
1
2
|
{
|
|
2
3
|
"type": "module",
|
|
3
4
|
"name": "@unifyplane/logsdk",
|
|
4
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.10",
|
|
5
6
|
|
|
6
7
|
"exports": {
|
|
7
8
|
".": {
|
|
8
9
|
"types": "./dist/index.d.ts",
|
|
9
10
|
"import": "./dist/index.js",
|
|
10
11
|
"default": "./dist/index.js"
|
|
11
|
-
},
|
|
12
|
-
"./sinks": {
|
|
13
|
-
"types": "./dist/sinks/index.d.ts",
|
|
14
|
-
"import": "./dist/sinks/index.js",
|
|
15
|
-
"default": "./dist/sinks/index.js"
|
|
16
12
|
}
|
|
17
13
|
},
|
|
18
14
|
|
|
@@ -20,7 +20,7 @@ export type SystemOwnership = {
|
|
|
20
20
|
system_type: string;
|
|
21
21
|
environment: string;
|
|
22
22
|
system_version: string;
|
|
23
|
-
instance_id
|
|
23
|
+
instance_id: string;
|
|
24
24
|
};
|
|
25
25
|
|
|
26
26
|
export type StepRecordOverrides = {
|
|
@@ -42,11 +42,15 @@ export type StepRecordOverrides = {
|
|
|
42
42
|
};
|
|
43
43
|
|
|
44
44
|
export function buildStepRecord(
|
|
45
|
+
step_id: string,
|
|
45
46
|
message: string,
|
|
46
47
|
sequence: number,
|
|
47
48
|
system: SystemOwnership,
|
|
48
49
|
overrides: StepRecordOverrides = {}
|
|
49
50
|
): StepRecord {
|
|
51
|
+
if (typeof step_id !== "string" || step_id.trim().length === 0) {
|
|
52
|
+
throw new Error("step_id must be a non-empty string");
|
|
53
|
+
}
|
|
50
54
|
const validatedMessage = message_constraints.validate(message);
|
|
51
55
|
validateSequence(sequence);
|
|
52
56
|
validateSystemOwnership(system);
|
|
@@ -61,6 +65,7 @@ export function buildStepRecord(
|
|
|
61
65
|
const baseRecord: Omit<StepRecord, "record_hash" | "hash_algorithm"> = {
|
|
62
66
|
record_version: RECORD_VERSION,
|
|
63
67
|
record_id: recordId,
|
|
68
|
+
step_id,
|
|
64
69
|
sequence,
|
|
65
70
|
timestamp_utc: timestampUtc,
|
|
66
71
|
monotonic_time: monotonicTime,
|
|
@@ -69,12 +74,13 @@ export function buildStepRecord(
|
|
|
69
74
|
system_type: system.system_type,
|
|
70
75
|
environment: system.environment,
|
|
71
76
|
system_version: system.system_version,
|
|
77
|
+
instance_id: system.instance_id,
|
|
72
78
|
message: validatedMessage,
|
|
73
79
|
context_hash: contextHash,
|
|
74
80
|
context_version: contextVersion,
|
|
75
81
|
};
|
|
76
82
|
|
|
77
|
-
|
|
83
|
+
baseRecord.instance_id = system.instance_id;
|
|
78
84
|
setOptionalField(baseRecord, "trace_id", overrides.trace_id);
|
|
79
85
|
setOptionalField(baseRecord, "span_id", overrides.span_id);
|
|
80
86
|
setOptionalField(baseRecord, "parent_step_id", overrides.parent_step_id);
|
|
@@ -115,6 +121,7 @@ function validateSystemOwnership(system: SystemOwnership): void {
|
|
|
115
121
|
"system_type",
|
|
116
122
|
"environment",
|
|
117
123
|
"system_version",
|
|
124
|
+
"instance_id",
|
|
118
125
|
];
|
|
119
126
|
|
|
120
127
|
for (const field of requiredFields) {
|
|
@@ -123,10 +130,6 @@ function validateSystemOwnership(system: SystemOwnership): void {
|
|
|
123
130
|
throw new Error(`Missing required system field: ${field}`);
|
|
124
131
|
}
|
|
125
132
|
}
|
|
126
|
-
|
|
127
|
-
if (system.instance_id !== undefined && typeof system.instance_id !== "string") {
|
|
128
|
-
throw new Error("instance_id must be a string when provided");
|
|
129
|
-
}
|
|
130
133
|
}
|
|
131
134
|
|
|
132
135
|
function createRecordId(): string {
|
|
@@ -242,6 +245,7 @@ const HASH_FIELD_ORDER: Array<
|
|
|
242
245
|
> = [
|
|
243
246
|
"record_version",
|
|
244
247
|
"record_id",
|
|
248
|
+
"step_id",
|
|
245
249
|
"sequence",
|
|
246
250
|
"timestamp_utc",
|
|
247
251
|
"monotonic_time",
|
package/src/core/types.ts
CHANGED
|
@@ -9,6 +9,7 @@ export interface StepRecord {
|
|
|
9
9
|
// 1. Identity & Versioning
|
|
10
10
|
record_version: "log.step.v1";
|
|
11
11
|
record_id: string;
|
|
12
|
+
step_id: string;
|
|
12
13
|
sequence: number;
|
|
13
14
|
|
|
14
15
|
// 2. Time (Dual Clock)
|
|
@@ -21,7 +22,7 @@ export interface StepRecord {
|
|
|
21
22
|
system_type: string;
|
|
22
23
|
environment: string;
|
|
23
24
|
system_version: string;
|
|
24
|
-
instance_id
|
|
25
|
+
instance_id: string;
|
|
25
26
|
|
|
26
27
|
// 4. Execution Correlation (Derived Automatically)
|
|
27
28
|
trace_id?: string;
|
package/src/index.ts
CHANGED
|
@@ -37,8 +37,13 @@ export type LogSDKConfig = {
|
|
|
37
37
|
mode?: "authoritative" | "non-authoritative";
|
|
38
38
|
};
|
|
39
39
|
|
|
40
|
+
/**
|
|
41
|
+
* LogApi v1.0: step(step_id: string, message?: string)
|
|
42
|
+
* - step_id: REQUIRED, kebab-case, no spaces, no uppercase, no punctuation (except dash/underscore)
|
|
43
|
+
* - message: OPTIONAL, human-readable, defaults to step_id if omitted
|
|
44
|
+
*/
|
|
40
45
|
export type LogApi = {
|
|
41
|
-
step(
|
|
46
|
+
step(step_id: string, message?: string): Promise<void>;
|
|
42
47
|
flush?: () => Promise<void>;
|
|
43
48
|
};
|
|
44
49
|
|
|
@@ -50,34 +55,68 @@ export function initLogSDK(config: LogSDKConfig): LogApi {
|
|
|
50
55
|
const idGenerator = createIdGenerator(config.system.instance_id);
|
|
51
56
|
const sinks = [...config.sinks];
|
|
52
57
|
|
|
58
|
+
// --- v1.0 API: step(step_id, message?) ---
|
|
53
59
|
const api: LogApi = {
|
|
54
|
-
async step(
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
60
|
+
async step(step_id: string, message?: string): Promise<void> {
|
|
61
|
+
// Validate step_id
|
|
62
|
+
if (typeof step_id !== "string" || step_id.length === 0) {
|
|
63
|
+
throw new NonComplianceError(
|
|
64
|
+
PAYLOAD_EMBEDDING_VIOLATION,
|
|
65
|
+
"step_id must be a non-empty string."
|
|
66
|
+
);
|
|
67
|
+
}
|
|
68
|
+
if (step_id.includes(" ")) {
|
|
69
|
+
throw new NonComplianceError(
|
|
70
|
+
PAYLOAD_EMBEDDING_VIOLATION,
|
|
71
|
+
"step_id must not contain spaces."
|
|
72
|
+
);
|
|
73
|
+
}
|
|
74
|
+
if (/[A-Z]/.test(step_id)) {
|
|
63
75
|
throw new NonComplianceError(
|
|
64
76
|
PAYLOAD_EMBEDDING_VIOLATION,
|
|
65
|
-
"
|
|
77
|
+
"step_id must not contain uppercase letters."
|
|
66
78
|
);
|
|
67
79
|
}
|
|
80
|
+
if (/[:.,;!?"'`]/.test(step_id)) {
|
|
81
|
+
throw new NonComplianceError(
|
|
82
|
+
PAYLOAD_EMBEDDING_VIOLATION,
|
|
83
|
+
"step_id must not contain punctuation except dash/underscore."
|
|
84
|
+
);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// message: optional, defaults to step_id
|
|
88
|
+
let stepMessage: string;
|
|
89
|
+
if (message === undefined) {
|
|
90
|
+
stepMessage = step_id;
|
|
91
|
+
} else {
|
|
92
|
+
if (typeof message !== "string") {
|
|
93
|
+
throw new NonComplianceError(
|
|
94
|
+
PAYLOAD_EMBEDDING_VIOLATION,
|
|
95
|
+
"Message must be a string."
|
|
96
|
+
);
|
|
97
|
+
}
|
|
98
|
+
stepMessage = message;
|
|
99
|
+
}
|
|
68
100
|
|
|
101
|
+
// Validate message using existing constraints
|
|
69
102
|
try {
|
|
70
|
-
assertValidMessage(
|
|
103
|
+
assertValidMessage(stepMessage);
|
|
71
104
|
} catch (error) {
|
|
72
105
|
throw new NonComplianceError(
|
|
73
106
|
PAYLOAD_EMBEDDING_VIOLATION,
|
|
74
|
-
error instanceof Error ? error.message : "Invalid message
|
|
107
|
+
error instanceof Error ? error.message : "Invalid message."
|
|
75
108
|
);
|
|
76
109
|
}
|
|
77
110
|
|
|
78
|
-
const record = buildStepRecord(
|
|
79
|
-
|
|
80
|
-
|
|
111
|
+
const record = buildStepRecord(
|
|
112
|
+
step_id,
|
|
113
|
+
stepMessage,
|
|
114
|
+
idGenerator.nextSequence(),
|
|
115
|
+
config.system,
|
|
116
|
+
{
|
|
117
|
+
record_id: idGenerator.nextRecordId(),
|
|
118
|
+
}
|
|
119
|
+
);
|
|
81
120
|
|
|
82
121
|
assertStepRecord(record);
|
|
83
122
|
|
|
@@ -109,8 +148,11 @@ export function createLogger(config: LogSDKConfig): LogApi {
|
|
|
109
148
|
}
|
|
110
149
|
|
|
111
150
|
|
|
112
|
-
export { fileNdjsonSink } from "./sinks/file_ndjson.js";
|
|
113
|
-
export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
|
|
151
|
+
// export { fileNdjsonSink } from "./sinks/file_ndjson.js";
|
|
152
|
+
// export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
|
|
114
153
|
|
|
115
154
|
// ---- Execution sinks (public API) ----
|
|
116
|
-
export { StdoutSink, FileNdjsonSink } from "./sinks/index.js";
|
|
155
|
+
// export { StdoutSink, FileNdjsonSink } from "./sinks/index.js"; -- Delete
|
|
156
|
+
|
|
157
|
+
export { createFileNdjsonSink } from "./sinks/file_ndjson_sink.js";
|
|
158
|
+
export { createStdoutSink } from "./sinks/stdout_sink.js";
|
|
@@ -77,14 +77,15 @@ export function assertApiSurface(surface: unknown): void {
|
|
|
77
77
|
}
|
|
78
78
|
}
|
|
79
79
|
|
|
80
|
+
|
|
80
81
|
if (!("step" in api)) {
|
|
81
82
|
throw new NonComplianceError(
|
|
82
83
|
API_SURFACE_VIOLATION,
|
|
83
|
-
"API surface must expose step(message)."
|
|
84
|
+
"API surface must expose step(step_id, message?)."
|
|
84
85
|
);
|
|
85
86
|
}
|
|
86
87
|
|
|
87
|
-
assertFunction(api.step, "step",
|
|
88
|
+
assertFunction(api.step, "step", 2);
|
|
88
89
|
|
|
89
90
|
if ("flush" in api) {
|
|
90
91
|
assertFunction(api.flush, "flush", 0);
|
|
Binary file
|
|
Binary file
|