@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/libs/contracts/dist/onboarding-base.js

@@ -1 +1,196 @@
-import{t as e}from"./schema/dist/SchemaModel.js";import{l as t}from"./schema/dist/ScalarTypeEnum.js";import"./schema/dist/index.js";import{n,t as r}from"./spec.js";import{e as i,t as a}from"./ownership.js";const o=new e({name:`SaveOnboardingDraftInput`,description:`Input for saving onboarding draft`,fields:{data:{type:t.JSON(),isOptional:!1}}}),s=new e({name:`SaveOnboardingDraftOutput`,description:`Output for saving onboarding draft`,fields:{id:{type:t.ID(),isOptional:!1},organizationId:{type:t.ID(),isOptional:!1}}});r({meta:{name:`base.onboarding.saveDraft`,version:1,stability:i.Beta,owners:[a.PlatformSigil],tags:[`onboarding`,`draft`],description:`Save or update onboarding draft for active organization`,goal:`Persist onboarding progress incrementally for resumption and safety`,context:`Auto-saves every few seconds during onboarding; enables users to leave and resume`},io:{input:o,output:s},policy:{auth:`user`,escalate:null},transport:{gql:{field:`saveOnboardingDraft`},rest:{method:`POST`}}});const c=new e({name:`GetOnboardingDraftOutput`,description:`Onboarding draft payload`,fields:{id:{type:t.ID(),isOptional:!0},organizationId:{type:t.ID(),isOptional:!0},data:{type:t.JSON(),isOptional:!0},createdAt:{type:t.DateTime(),isOptional:!0},updatedAt:{type:t.DateTime(),isOptional:!0}}});n({meta:{name:`base.onboarding.getDraft`,version:1,stability:i.Beta,owners:[a.PlatformSigil],tags:[`onboarding`,`draft`],description:`Get onboarding draft for active organization`,goal:`Retrieve saved onboarding progress`,context:`Called on mount to restore in-progress onboarding`},io:{input:null,output:c},policy:{auth:`user`,escalate:null},transport:{gql:{field:`getOnboardingDraft`},rest:{method:`GET`}}});const l=new e({name:`DeleteOnboardingDraftOutput`,description:`Result of delete operation`,fields:{ok:{type:t.Boolean(),isOptional:!1}}});r({meta:{name:`base.onboarding.deleteDraft`,version:1,stability:i.Beta,owners:[a.PlatformSigil],tags:[`onboarding`,`draft`],description:`Delete onboarding draft for active organization`,goal:`Clear draft after completion or if user wants to restart`,context:`Called after successful onboarding or explicit user reset`},io:{input:null,output:l},policy:{auth:`user`,escalate:null},transport:{gql:{field:`deleteOnboardingDraft`},rest:{method:`POST`}}});const u=new e({name:`CompleteOnboardingBaseInput`,description:`Input for completing onboarding`,fields:{data:{type:t.JSON(),isOptional:!1}}}),d=new e({name:`CompleteOnboardingBaseOutput`,description:`Result of onboarding completion`,fields:{success:{type:t.Boolean(),isOptional:!1},userId:{type:t.ID(),isOptional:!0},organizationId:{type:t.ID(),isOptional:!0}}});r({meta:{name:`base.onboarding.complete`,version:1,stability:i.Beta,owners:[a.PlatformSigil],tags:[`onboarding`],description:`Complete onboarding and finalize user/organization setup`,goal:`Transition from draft to active profile`,context:`Validates all required fields, creates/updates entities, marks onboarding complete`},io:{input:u,output:d},policy:{auth:`user`,escalate:null},transport:{gql:{field:`completeOnboarding`},rest:{method:`POST`}}});export{l as d,c as l,d as m,o,u as p,s};
+import { SchemaModel } from "./schema/dist/SchemaModel.js";
+import { ScalarTypeEnum } from "./schema/dist/ScalarTypeEnum.js";
+import "./schema/dist/index.js";
+import { defineCommand, defineQuery } from "./spec.js";
+import { OwnersEnum, StabilityEnum } from "./ownership.js";
+
+//#region ../../libs/contracts/dist/onboarding-base.js
+/**
+* Shared base contracts for onboarding flows across verticals.
+* These operations are reusable for any app that needs multi-step onboarding with draft persistence.
+*/
+/** Save/update onboarding draft (auto-save during flow) */
+const SaveOnboardingDraftInput = new SchemaModel({
+	name: "SaveOnboardingDraftInput",
+	description: "Input for saving onboarding draft",
+	fields: { data: {
+		type: ScalarTypeEnum.JSON(),
+		isOptional: false
+	} }
+});
+const SaveOnboardingDraftOutput = new SchemaModel({
+	name: "SaveOnboardingDraftOutput",
+	description: "Output for saving onboarding draft",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		}
+	}
+});
+const SaveOnboardingDraftBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.saveDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Save or update onboarding draft for active organization",
+		goal: "Persist onboarding progress incrementally for resumption and safety",
+		context: "Auto-saves every few seconds during onboarding; enables users to leave and resume"
+	},
+	io: {
+		input: SaveOnboardingDraftInput,
+		output: SaveOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "saveOnboardingDraft" },
+		rest: { method: "POST" }
+	}
+});
+/** Get current onboarding draft (on mount/restore) */
+const GetOnboardingDraftOutput = new SchemaModel({
+	name: "GetOnboardingDraftOutput",
+	description: "Onboarding draft payload",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		data: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const GetOnboardingDraftBaseSpec = defineQuery({
+	meta: {
+		name: "base.onboarding.getDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Get onboarding draft for active organization",
+		goal: "Retrieve saved onboarding progress",
+		context: "Called on mount to restore in-progress onboarding"
+	},
+	io: {
+		input: null,
+		output: GetOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "getOnboardingDraft" },
+		rest: { method: "GET" }
+	}
+});
+/** Delete onboarding draft (cleanup after completion or cancel) */
+const DeleteOnboardingDraftOutput = new SchemaModel({
+	name: "DeleteOnboardingDraftOutput",
+	description: "Result of delete operation",
+	fields: { ok: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const DeleteOnboardingDraftBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.deleteDraft",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding", "draft"],
+		description: "Delete onboarding draft for active organization",
+		goal: "Clear draft after completion or if user wants to restart",
+		context: "Called after successful onboarding or explicit user reset"
+	},
+	io: {
+		input: null,
+		output: DeleteOnboardingDraftOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "deleteOnboardingDraft" },
+		rest: { method: "POST" }
+	}
+});
+/** Complete onboarding (final submit, creates entities) */
+const CompleteOnboardingBaseInput = new SchemaModel({
+	name: "CompleteOnboardingBaseInput",
+	description: "Input for completing onboarding",
+	fields: { data: {
+		type: ScalarTypeEnum.JSON(),
+		isOptional: false
+	} }
+});
+const CompleteOnboardingBaseOutput = new SchemaModel({
+	name: "CompleteOnboardingBaseOutput",
+	description: "Result of onboarding completion",
+	fields: {
+		success: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		organizationId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		}
+	}
+});
+const CompleteOnboardingBaseSpec = defineCommand({
+	meta: {
+		name: "base.onboarding.complete",
+		version: 1,
+		stability: StabilityEnum.Beta,
+		owners: [OwnersEnum.PlatformSigil],
+		tags: ["onboarding"],
+		description: "Complete onboarding and finalize user/organization setup",
+		goal: "Transition from draft to active profile",
+		context: "Validates all required fields, creates/updates entities, marks onboarding complete"
+	},
+	io: {
+		input: CompleteOnboardingBaseInput,
+		output: CompleteOnboardingBaseOutput
+	},
+	policy: {
+		auth: "user",
+		escalate: null
+	},
+	transport: {
+		gql: { field: "completeOnboarding" },
+		rest: { method: "POST" }
+	}
+});
+
+//#endregion
+export { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, DeleteOnboardingDraftOutput, GetOnboardingDraftOutput, SaveOnboardingDraftInput, SaveOnboardingDraftOutput };

package/dist/libs/contracts/dist/openapi.js

@@ -1 +1,75 @@
-import{n as e,t}from"./jsonschema.js";function n(e,t){return`${e.replace(/\./g,`_`)}_v${t}`}function r(e,t,r){return`${e}_${n(t,r)}`}function i(e,t){return(t??(e===`query`?`GET`:`POST`)).toLowerCase()}function a(t){let n=t.transport?.rest?.path??e(t.meta.name,t.meta.version);return n.startsWith(`/`)?n:`/${n}`}function o(e,o={}){let s=e.listSpecs().filter(e=>e.meta.kind===`command`||e.meta.kind===`query`).slice().sort((e,t)=>{let n=e.meta.name.localeCompare(t.meta.name);return n===0?e.meta.version-t.meta.version:n}),c={openapi:`3.1.0`,info:{title:o.title??`ContractSpec API`,version:o.version??`0.0.0`,...o.description?{description:o.description}:{}},...o.servers?{servers:o.servers}:{},paths:{},components:{schemas:{}}};for(let e of s){let o=t(e),s=i(e.meta.kind,e.transport?.rest?.method),l=a(e),u=n(e.meta.name,e.meta.version),d=c.paths[l]??={},f={operationId:u,summary:e.meta.description??e.meta.name,description:e.meta.description,tags:e.meta.tags??[],"x-contractspec":{name:e.meta.name,version:e.meta.version,kind:e.meta.kind},responses:{}};if(o.input){let t=r(`Input`,e.meta.name,e.meta.version);c.components.schemas[t]=o.input,f.requestBody={required:!0,content:{"application/json":{schema:{$ref:`#/components/schemas/${t}`}}}}}let p={};if(o.output){let t=r(`Output`,e.meta.name,e.meta.version);c.components.schemas[t]=o.output,p[200]={description:`OK`,content:{"application/json":{schema:{$ref:`#/components/schemas/${t}`}}}}}else p[200]={description:`OK`};f.responses=p,d[s]=f}return c}export{o};
+import { defaultRestPath, jsonSchemaForSpec } from "./jsonschema.js";
+
+//#region ../../libs/contracts/dist/openapi.js
+function toOperationId(name, version) {
+	return `${name.replace(/\./g, "_")}_v${version}`;
+}
+function toSchemaName(prefix, name, version) {
+	return `${prefix}_${toOperationId(name, version)}`;
+}
+function toHttpMethod(kind, override) {
+	return (override ?? (kind === "query" ? "GET" : "POST")).toLowerCase();
+}
+function toRestPath(spec) {
+	const path = spec.transport?.rest?.path ?? defaultRestPath(spec.meta.name, spec.meta.version);
+	return path.startsWith("/") ? path : `/${path}`;
+}
+function openApiForRegistry(registry, options = {}) {
+	const specs = registry.listSpecs().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
+		const byName = a.meta.name.localeCompare(b.meta.name);
+		return byName !== 0 ? byName : a.meta.version - b.meta.version;
+	});
+	const doc = {
+		openapi: "3.1.0",
+		info: {
+			title: options.title ?? "ContractSpec API",
+			version: options.version ?? "0.0.0",
+			...options.description ? { description: options.description } : {}
+		},
+		...options.servers ? { servers: options.servers } : {},
+		paths: {},
+		components: { schemas: {} }
+	};
+	for (const spec of specs) {
+		const schema = jsonSchemaForSpec(spec);
+		const method = toHttpMethod(spec.meta.kind, spec.transport?.rest?.method);
+		const path = toRestPath(spec);
+		const operationId = toOperationId(spec.meta.name, spec.meta.version);
+		const pathItem = doc.paths[path] ??= {};
+		const op = {
+			operationId,
+			summary: spec.meta.description ?? spec.meta.name,
+			description: spec.meta.description,
+			tags: spec.meta.tags ?? [],
+			"x-contractspec": {
+				name: spec.meta.name,
+				version: spec.meta.version,
+				kind: spec.meta.kind
+			},
+			responses: {}
+		};
+		if (schema.input) {
+			const inputName = toSchemaName("Input", spec.meta.name, spec.meta.version);
+			doc.components.schemas[inputName] = schema.input;
+			op["requestBody"] = {
+				required: true,
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${inputName}` } } }
+			};
+		}
+		const responses = {};
+		if (schema.output) {
+			const outputName = toSchemaName("Output", spec.meta.name, spec.meta.version);
+			doc.components.schemas[outputName] = schema.output;
+			responses["200"] = {
+				description: "OK",
+				content: { "application/json": { schema: { $ref: `#/components/schemas/${outputName}` } } }
+			};
+		} else responses["200"] = { description: "OK" };
+		op["responses"] = responses;
+		pathItem[method] = op;
+	}
+	return doc;
+}
+
+//#endregion
+export { openApiForRegistry };

package/dist/libs/contracts/dist/ownership.js

@@ -1 +1,21 @@
-const e={Idea:`idea`,InCreation:`in_creation`,Experimental:`experimental`,Beta:`beta`,Stable:`stable`,Deprecated:`deprecated`},t={ProductColiving:`product.coliving`,ProductStrit:`product.strit`,ProductArtisanos:`product.artisanos`,PlatformSigil:`platform.sigil`,PlatformMarketplace:`platform.marketplace`,PlatformContent:`platform.content`,PlatformFeatureFlags:`platform.featureflags`},n={Spots:`spots`,Collectivity:`collectivity`,Marketplace:`marketplace`,Sellers:`sellers`,Auth:`auth`,Login:`login`,Signup:`signup`,Guide:`guide`,Docs:`docs`,I18n:`i18n`,AtomicPages:`atomic:pages`,Incident:`incident`,Hygiene:`hygiene`,WeeklyPulse:`weekly_pulse`,WebAuth:`webauth`};export{e,n as r,t};
+//#region ../../libs/contracts/dist/ownership.js
+const StabilityEnum = {
+	Idea: "idea",
+	InCreation: "in_creation",
+	Experimental: "experimental",
+	Beta: "beta",
+	Stable: "stable",
+	Deprecated: "deprecated"
+};
+const OwnersEnum = {
+	ProductColiving: "product.coliving",
+	ProductStrit: "product.strit",
+	ProductArtisanos: "product.artisanos",
+	PlatformSigil: "platform.sigil",
+	PlatformMarketplace: "platform.marketplace",
+	PlatformContent: "platform.content",
+	PlatformFeatureFlags: "platform.featureflags"
+};
+
+//#endregion
+export { OwnersEnum, StabilityEnum };

package/dist/libs/contracts/dist/presentations.js

@@ -1 +1 @@
-import e from"zod";
+import z from "zod";

package/dist/libs/contracts/dist/presentations.v2.js

@@ -1 +1,11 @@
-import"react";import e from"turndown";new e;
+import "react";
+import TurndownService from "turndown";
+
+//#region ../../libs/contracts/dist/presentations.v2.js
+/**
+* Pluggable transform engine that renders descriptors to various targets
+* and runs validators (e.g., basic metadata checks, PII redaction policies).
+*/
+const turndown = new TurndownService();
+
+//#endregion

package/dist/libs/contracts/dist/prompt.js

@@ -1 +1 @@
-import"zod";
+import "zod";

package/dist/libs/contracts/dist/promptRegistry.js

@@ -1 +1 @@
-import"zod";
+import "zod";

package/dist/libs/contracts/dist/regenerator/index.js

@@ -1 +1,2 @@
-import{e,n as t,t as n}from"./utils.js";import{i as r}from"./service.js";
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./utils.js";
+import { RegeneratorService } from "./service.js";

package/dist/libs/contracts/dist/regenerator/service.js

@@ -1 +1,92 @@
-import{e,n as t,t as n}from"./utils.js";import{setTimeout as r}from"node:timers/promises";var i=class{contexts;lastPoll=new Map;timer;running=!1;pollInterval;batchDuration;clock;constructor(e){if(this.options=e,this.contexts=new Map(e.contexts.map(e=>[e.id,e])),this.pollInterval=e.pollIntervalMs??6e4,this.batchDuration=e.batchDurationMs??3e5,this.clock=e.clock??(()=>new Date),this.options.rules.length===0)throw Error(`RegeneratorService requires at least one rule`)}start(){this.running||(this.running=!0,this.tick(),this.timer=setInterval(()=>{this.tick()},this.pollInterval))}stop(){this.running&&(this.running=!1,this.timer&&=(clearInterval(this.timer),void 0))}async runOnce(){await this.tick()}async tick(){let e=this.clock(),t=new Date(e.getTime()-this.batchDuration);for(let n of this.contexts.values()){let r=this.lastPoll.get(n.id)??t;await this.evaluateContext(n,r,e),this.lastPoll.set(n.id,e)}}async evaluateContext(e,t,n){let r=await this.collectSignals(e,t,n);if(r.length!==0)for(let t of this.options.rules){let n=[];try{n=await t.evaluate(e,r)}catch(e){console.error(`[regenerator] rule ${t.id} failed`,e instanceof Error?e:Error(String(e)));continue}await this.flushProposals(e,n)}}async collectSignals(r,i,a){let o=[],{adapters:s}=this.options;if(s.telemetry){let t=await s.telemetry.pollTelemetry(r,i,a);o.push(...t.map(t=>e(r.id,t,this.clock)))}if(s.errors){let e=await s.errors.pollErrors(r,i,a);o.push(...e.map(e=>n(r.id,e,this.clock)))}if(s.behavior){let e=await s.behavior.pollBehavior(r,i,a);o.push(...e.map(e=>t(r.id,e,this.clock)))}return o}async flushProposals(e,t){for(let n of t)n.signalIds.length!==0&&(await this.options.sink.submit(e,n),t.length>10&&await r(0))}};export{i};
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./utils.js";
+import { setTimeout } from "node:timers/promises";
+
+//#region ../../libs/contracts/dist/regenerator/service.js
+const DEFAULT_POLL_INTERVAL = 6e4;
+const DEFAULT_BATCH_DURATION = 5 * 6e4;
+var RegeneratorService = class {
+	contexts;
+	lastPoll = /* @__PURE__ */ new Map();
+	timer;
+	running = false;
+	pollInterval;
+	batchDuration;
+	clock;
+	constructor(options) {
+		this.options = options;
+		this.contexts = new Map(options.contexts.map((ctx) => [ctx.id, ctx]));
+		this.pollInterval = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL;
+		this.batchDuration = options.batchDurationMs ?? DEFAULT_BATCH_DURATION;
+		this.clock = options.clock ?? (() => /* @__PURE__ */ new Date());
+		if (this.options.rules.length === 0) throw new Error("RegeneratorService requires at least one rule");
+	}
+	start() {
+		if (this.running) return;
+		this.running = true;
+		this.tick();
+		this.timer = setInterval(() => {
+			this.tick();
+		}, this.pollInterval);
+	}
+	stop() {
+		if (!this.running) return;
+		this.running = false;
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = void 0;
+		}
+	}
+	async runOnce() {
+		await this.tick();
+	}
+	async tick() {
+		const now = this.clock();
+		const sinceDefault = new Date(now.getTime() - this.batchDuration);
+		for (const context of this.contexts.values()) {
+			const last = this.lastPoll.get(context.id) ?? sinceDefault;
+			await this.evaluateContext(context, last, now);
+			this.lastPoll.set(context.id, now);
+		}
+	}
+	async evaluateContext(context, since, until) {
+		const signals = await this.collectSignals(context, since, until);
+		if (signals.length === 0) return;
+		for (const rule of this.options.rules) {
+			let proposals = [];
+			try {
+				proposals = await rule.evaluate(context, signals);
+			} catch (error) {
+				console.error(`[regenerator] rule ${rule.id} failed`, error instanceof Error ? error : new Error(String(error)));
+				continue;
+			}
+			await this.flushProposals(context, proposals);
+		}
+	}
+	async collectSignals(context, since, until) {
+		const envelopes = [];
+		const { adapters } = this.options;
+		if (adapters.telemetry) {
+			const telemetrySignals = await adapters.telemetry.pollTelemetry(context, since, until);
+			envelopes.push(...telemetrySignals.map((signal) => telemetryToEnvelope(context.id, signal, this.clock)));
+		}
+		if (adapters.errors) {
+			const errorSignals = await adapters.errors.pollErrors(context, since, until);
+			envelopes.push(...errorSignals.map((signal) => errorToEnvelope(context.id, signal, this.clock)));
+		}
+		if (adapters.behavior) {
+			const behaviorSignals = await adapters.behavior.pollBehavior(context, since, until);
+			envelopes.push(...behaviorSignals.map((signal) => behaviorToEnvelope(context.id, signal, this.clock)));
+		}
+		return envelopes;
+	}
+	async flushProposals(context, proposals) {
+		for (const proposal of proposals) {
+			if (proposal.signalIds.length === 0) continue;
+			await this.options.sink.submit(context, proposal);
+			if (proposals.length > 10) await setTimeout(0);
+		}
+	}
+};
+
+//#endregion
+export { RegeneratorService };

package/dist/libs/contracts/dist/regenerator/utils.js

@@ -1 +1,51 @@
-function e(e,t,n){return{type:`telemetry`,contextId:e,signal:r(t,n)}}function t(e,t,n){return{type:`error`,contextId:e,signal:i(t,n)}}function n(e,t,n){return{type:`behavior`,contextId:e,signal:a(t,n)}}function r(e,t){return{...e,windowStart:o(e.windowStart,t),windowEnd:o(e.windowEnd,t)}}function i(e,t){return{...e,occurredAt:o(e.occurredAt,t)}}function a(e,t){return{...e,windowStart:o(e.windowStart,t),windowEnd:o(e.windowEnd,t)}}function o(e,t){if(e instanceof Date)return e;let n=new Date(e);return Number.isNaN(n.getTime())?t():n}export{e,n,t};
+//#region ../../libs/contracts/dist/regenerator/utils.js
+function telemetryToEnvelope(contextId, signal, clock) {
+	return {
+		type: "telemetry",
+		contextId,
+		signal: normalizeTelemetryDates(signal, clock)
+	};
+}
+function errorToEnvelope(contextId, signal, clock) {
+	return {
+		type: "error",
+		contextId,
+		signal: normalizeErrorDates(signal, clock)
+	};
+}
+function behaviorToEnvelope(contextId, signal, clock) {
+	return {
+		type: "behavior",
+		contextId,
+		signal: normalizeBehaviorDates(signal, clock)
+	};
+}
+function normalizeTelemetryDates(signal, clock) {
+	return {
+		...signal,
+		windowStart: toDate(signal.windowStart, clock),
+		windowEnd: toDate(signal.windowEnd, clock)
+	};
+}
+function normalizeErrorDates(signal, clock) {
+	return {
+		...signal,
+		occurredAt: toDate(signal.occurredAt, clock)
+	};
+}
+function normalizeBehaviorDates(signal, clock) {
+	return {
+		...signal,
+		windowStart: toDate(signal.windowStart, clock),
+		windowEnd: toDate(signal.windowEnd, clock)
+	};
+}
+function toDate(value, clock) {
+	if (value instanceof Date) return value;
+	const parsed = new Date(value);
+	if (Number.isNaN(parsed.getTime())) return clock();
+	return parsed;
+}
+
+//#endregion
+export { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope };