@vurb/core 3.3.4 → 3.6.0

package/dist/model/defineModel.d.ts

@@ -0,0 +1,167 @@
+/**
+ * defineModel — Eloquent-inspired Model Definition for Vurb.ts
+ *
+ * Synthesizes the best DX patterns from 10 globally acclaimed frameworks:
+ *   • Laravel:  $casts, $fillable, $hidden, $guarded, timestamps()
+ *   • Django:   choices (enum), verbose_name (label-first)
+ *   • Rails:    attr_accessible (whitelist) + attr_protected (blacklist)
+ *   • Prisma:   @default() values
+ *   • Pydantic: Field(alias=, examples=, description=)
+ *   • Drizzle:  column-as-function type helpers
+ *   • Convex:   defineTable() factory
+ *   • Spring:   @JsonIgnore → hidden
+ *   • NestJS:   DTOs per operation → fillable profiles
+ *   • Mongoose: schema options in closure
+ *
+ * @example
+ * ```typescript
+ * import { defineModel } from '@vurb/core';
+ *
+ * export const TaskModel = defineModel('Task', m => {
+ *   m.casts({
+ *     title:       m.string('Task title'),
+ *     description: m.text('Description in markdown'),
+ *     status:      m.enum('Status', ['open', 'done']).default('open'),
+ *     due_date:    m.date('Due date'),
+ *     is_bug:      m.boolean('Bug flag').default(false),
+ *   });
+ *
+ *   m.timestamps();
+ *   m.hidden(['internal_id']);
+ *   m.guarded(['uuid', 'created_at', 'updated_at']);
+ *
+ *   m.fillable({
+ *     create: ['title', 'description', 'due_date', 'is_bug'],
+ *     update: ['title', 'description', 'due_date', 'is_bug'],
+ *     filter: ['title', 'status', 'is_bug'],
+ *   });
+ * });
+ * ```
+ *
+ * @module
+ */
+import { z, type ZodType, type ZodObject, type ZodRawShape } from 'zod';
+/** Internal field type discriminator */
+type FieldType = 'string' | 'text' | 'number' | 'boolean' | 'date' | 'timestamp' | 'uuid' | 'id' | 'enum' | 'object' | 'list';
+/** A field definition descriptor — chainable for .default(), .alias(), .examples() */
+export declare class FieldDef {
+    /** @internal */ readonly _type: FieldType;
+    /** @internal */ readonly _label: string | undefined;
+    /** @internal */ readonly _enumValues: readonly [string, ...string[]] | undefined;
+    /** @internal */ readonly _shape: Record<string, FieldDef> | undefined;
+    /** @internal */ _defaultValue?: unknown;
+    /** @internal */ _alias?: string;
+    /** @internal */ _examples?: unknown[];
+    constructor(type: FieldType, label?: string, options?: {
+        enumValues?: readonly [string, ...string[]];
+        shape?: Record<string, FieldDef>;
+    });
+    /** Set a default value (Prisma-inspired `@default()`) */
+    default(value: unknown): this;
+    /** Set an alias name (Pydantic-inspired `Field(alias=)`) */
+    alias(name: string): this;
+    /** Set example values (Pydantic-inspired `Field(examples=[])`) */
+    examples(values: unknown[]): this;
+}
+/**
+ * Compile a FieldDef into a Zod schema for input context.
+ *
+ * Unlike `compileField()` (which defaults everything to optional for output schemas),
+ * this function produces schemas suitable for tool input parameters:
+ * - For **create**: string/text fields become required `z.string()`, number fields become optional
+ * - For **update/filter** (`forceOptional = true`): all fields become optional
+ *
+ * @param def - Field definition to compile
+ * @param forceOptional - If true, all fields become optional (update/filter semantics)
+ * @returns Zod schema for input validation
+ */
+export declare function compileFieldForInput(def: FieldDef, forceOptional: boolean): ZodType;
+/** The compiled Model object returned by `defineModel()` */
+export interface Model {
+    /** Model name (e.g. 'Task') */
+    readonly name: string;
+    /** Compiled Zod schema — compatible with Presenter.schema() */
+    readonly schema: ZodObject<ZodRawShape>;
+    /** Field definitions map */
+    readonly fields: Record<string, FieldDef>;
+    /** Hidden fields — never shown in output (Spring @JsonIgnore) */
+    readonly hidden: string[];
+    /** Guarded fields — never fillable (Rails attr_protected) */
+    readonly guarded: string[];
+    /** Input profiles per operation (Laravel $fillable) */
+    readonly input: Record<string, string[]>;
+    /** Default values (Prisma @default) */
+    readonly defaults: Record<string, unknown>;
+    /**
+     * Apply field aliases — renames agent-facing keys to API-facing keys.
+     * Pydantic-inspired `model_dump(by_alias=True)`.
+     * Strips undefined values. Non-aliased keys pass through unchanged.
+     *
+     * @example
+     * ```typescript
+     * // Model: content → .alias('description')
+     * ProposalModel.toApi({ title: 'X', content: 'Y' })
+     * // → { title: 'X', description: 'Y' }
+     * ```
+     */
+    readonly toApi: (data: Record<string, unknown>) => Record<string, unknown>;
+    /** Type helper — `typeof model.infer` gives you the TS type */
+    readonly infer: z.infer<ZodObject<ZodRawShape>>;
+}
+/**
+ * Builder class that exposes type functions and configuration methods.
+ * Passed as `m` in the `defineModel()` closure.
+ */
+export declare class ModelBuilder {
+    /** @internal */ _fields: Record<string, FieldDef>;
+    /** @internal */ _hidden: string[];
+    /** @internal */ _guarded: string[];
+    /** @internal */ _fillableProfiles: Record<string, string[]>;
+    /** String field — general purpose text */
+    string(label?: string): FieldDef;
+    /** Text field — semantic: markdown, multiline, long content */
+    text(label?: string): FieldDef;
+    /** Numeric field */
+    number(label?: string): FieldDef;
+    /** Boolean field */
+    boolean(label?: string): FieldDef;
+    /** Date field — automatically hints YYYY-MM-DD format */
+    date(label?: string): FieldDef;
+    /** Timestamp field — ISO datetime */
+    timestamp(label?: string): FieldDef;
+    /** UUID field — string with UUID semantics */
+    uuid(label?: string): FieldDef;
+    /** ID field — always required, numeric */
+    id(label?: string): FieldDef;
+    /** Enum field — Django-style choices, tells AI valid values */
+    enum(label: string, values: readonly [string, ...string[]]): FieldDef;
+    /** Nested object field */
+    object(label: string, shape: Record<string, FieldDef>): FieldDef;
+    /** Array of objects field */
+    list(label: string, shape: Record<string, FieldDef>): FieldDef;
+    /** Define field types and labels — like Laravel's `$casts` */
+    casts(fields: Record<string, FieldDef>): void;
+    /** Add created_at + updated_at timestamp fields — like Laravel's `timestamps()` */
+    timestamps(): void;
+    /** Fields hidden from output — like Spring's `@JsonIgnore` or Laravel's `$hidden` */
+    hidden(fields: string[]): void;
+    /** Fields that can NEVER be input — like Rails' `attr_protected` or Laravel's `$guarded` */
+    guarded(fields: string[]): void;
+    /** Define input profiles per operation — like Laravel's `$fillable` + NestJS DTOs */
+    fillable(profiles: Record<string, string[]>): void;
+    /** @internal Compile all fields into a Zod schema */
+    _compile(): {
+        schema: ZodObject<ZodRawShape>;
+        defaults: Record<string, unknown>;
+    };
+}
+/**
+ * Define a Model — one file, one entity, one source of truth.
+ *
+ * @param name - Model name (e.g. 'Task', 'Sprint', 'Project')
+ * @param configure - Closure function that receives a `ModelBuilder` (`m`)
+ * @returns Compiled `Model` with `.schema`, `.fields`, `.input`, `.hidden`, `.guarded`
+ */
+export declare function defineModel(name: string, configure: (m: ModelBuilder) => void): Model;
+export {};
+//# sourceMappingURL=defineModel.d.ts.map

package/dist/model/defineModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModel.d.ts","sourceRoot":"","sources":["../../src/model/defineModel.ts"],"names":[],"mappings":"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"}

package/dist/model/defineModel.js

@@ -0,0 +1,345 @@
+/**
+ * defineModel — Eloquent-inspired Model Definition for Vurb.ts
+ *
+ * Synthesizes the best DX patterns from 10 globally acclaimed frameworks:
+ *   • Laravel:  $casts, $fillable, $hidden, $guarded, timestamps()
+ *   • Django:   choices (enum), verbose_name (label-first)
+ *   • Rails:    attr_accessible (whitelist) + attr_protected (blacklist)
+ *   • Prisma:   @default() values
+ *   • Pydantic: Field(alias=, examples=, description=)
+ *   • Drizzle:  column-as-function type helpers
+ *   • Convex:   defineTable() factory
+ *   • Spring:   @JsonIgnore → hidden
+ *   • NestJS:   DTOs per operation → fillable profiles
+ *   • Mongoose: schema options in closure
+ *
+ * @example
+ * ```typescript
+ * import { defineModel } from '@vurb/core';
+ *
+ * export const TaskModel = defineModel('Task', m => {
+ *   m.casts({
+ *     title:       m.string('Task title'),
+ *     description: m.text('Description in markdown'),
+ *     status:      m.enum('Status', ['open', 'done']).default('open'),
+ *     due_date:    m.date('Due date'),
+ *     is_bug:      m.boolean('Bug flag').default(false),
+ *   });
+ *
+ *   m.timestamps();
+ *   m.hidden(['internal_id']);
+ *   m.guarded(['uuid', 'created_at', 'updated_at']);
+ *
+ *   m.fillable({
+ *     create: ['title', 'description', 'due_date', 'is_bug'],
+ *     update: ['title', 'description', 'due_date', 'is_bug'],
+ *     filter: ['title', 'status', 'is_bug'],
+ *   });
+ * });
+ * ```
+ *
+ * @module
+ */
+import { z } from 'zod';
+/** A field definition descriptor — chainable for .default(), .alias(), .examples() */
+export class FieldDef {
+    /** @internal */ _type;
+    /** @internal */ _label;
+    /** @internal */ _enumValues;
+    /** @internal */ _shape;
+    /** @internal */ _defaultValue;
+    /** @internal */ _alias;
+    /** @internal */ _examples;
+    constructor(type, label, options) {
+        this._type = type;
+        this._label = label;
+        this._enumValues = options?.enumValues;
+        this._shape = options?.shape;
+    }
+    /** Set a default value (Prisma-inspired `@default()`) */
+    default(value) {
+        this._defaultValue = value;
+        return this;
+    }
+    /** Set an alias name (Pydantic-inspired `Field(alias=)`) */
+    alias(name) {
+        this._alias = name;
+        return this;
+    }
+    /** Set example values (Pydantic-inspired `Field(examples=[])`) */
+    examples(values) {
+        this._examples = values;
+        return this;
+    }
+}
+// ── Compile FieldDef → Zod ──────────────────────────────
+function compileField(def) {
+    let schema;
+    switch (def._type) {
+        case 'string':
+        case 'text':
+            schema = z.string();
+            break;
+        case 'number':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'date':
+            schema = z.string();
+            break;
+        case 'timestamp':
+            schema = z.string();
+            break;
+        case 'uuid':
+            schema = z.string();
+            break;
+        case 'id':
+            // IDs are always required — return early with describe if present
+            schema = z.number();
+            if (def._label)
+                schema = schema.describe(def._label);
+            return schema;
+        case 'enum':
+            schema = z.enum(def._enumValues);
+            break;
+        case 'object': {
+            const shape = {};
+            if (def._shape) {
+                for (const [key, childDef] of Object.entries(def._shape)) {
+                    shape[key] = compileField(childDef);
+                }
+            }
+            schema = z.object(shape);
+            break;
+        }
+        case 'list': {
+            const itemShape = {};
+            if (def._shape) {
+                for (const [key, childDef] of Object.entries(def._shape)) {
+                    itemShape[key] = compileField(childDef);
+                }
+            }
+            schema = z.array(z.object(itemShape));
+            break;
+        }
+    }
+    // Add description (label) — Drizzle + Django verbose_name
+    if (def._label) {
+        // Add format hint for date fields — automatically hint YYYY-MM-DD
+        const label = def._type === 'date'
+            ? `${def._label} (YYYY-MM-DD)`
+            : def._label;
+        schema = schema.describe(label);
+    }
+    // Everything except `id` is optional + nullable by default
+    // (API responses may omit fields)
+    if (def._type === 'boolean' || def._type === 'list') {
+        schema = schema.optional();
+    }
+    else {
+        schema = schema.optional().nullable();
+    }
+    return schema;
+}
+/**
+ * Compile a FieldDef into a Zod schema for input context.
+ *
+ * Unlike `compileField()` (which defaults everything to optional for output schemas),
+ * this function produces schemas suitable for tool input parameters:
+ * - For **create**: string/text fields become required `z.string()`, number fields become optional
+ * - For **update/filter** (`forceOptional = true`): all fields become optional
+ *
+ * @param def - Field definition to compile
+ * @param forceOptional - If true, all fields become optional (update/filter semantics)
+ * @returns Zod schema for input validation
+ */
+export function compileFieldForInput(def, forceOptional) {
+    let schema;
+    switch (def._type) {
+        case 'string':
+        case 'text':
+        case 'uuid':
+        case 'date':
+        case 'timestamp':
+            schema = z.string();
+            break;
+        case 'number':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'id':
+            schema = z.number();
+            break;
+        case 'enum':
+            schema = z.enum(def._enumValues);
+            break;
+        case 'object': {
+            const shape = {};
+            if (def._shape) {
+                for (const [key, childDef] of Object.entries(def._shape)) {
+                    shape[key] = compileFieldForInput(childDef, false);
+                }
+            }
+            schema = z.object(shape);
+            break;
+        }
+        case 'list': {
+            const itemShape = {};
+            if (def._shape) {
+                for (const [key, childDef] of Object.entries(def._shape)) {
+                    itemShape[key] = compileFieldForInput(childDef, false);
+                }
+            }
+            schema = z.array(z.object(itemShape));
+            break;
+        }
+    }
+    // Add description (label)
+    if (def._label) {
+        const label = def._type === 'date'
+            ? `${def._label} (YYYY-MM-DD)`
+            : def._label;
+        schema = schema.describe(label);
+    }
+    // Apply optionality: forceOptional makes everything optional
+    if (forceOptional) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+// ── ModelBuilder (the `m` argument) ─────────────────────
+/**
+ * Builder class that exposes type functions and configuration methods.
+ * Passed as `m` in the `defineModel()` closure.
+ */
+export class ModelBuilder {
+    /** @internal */ _fields = {};
+    /** @internal */ _hidden = [];
+    /** @internal */ _guarded = [];
+    /** @internal */ _fillableProfiles = {};
+    // ── Type Functions (Drizzle-style) ──────────────────
+    /** String field — general purpose text */
+    string(label) {
+        return new FieldDef('string', label);
+    }
+    /** Text field — semantic: markdown, multiline, long content */
+    text(label) {
+        return new FieldDef('text', label);
+    }
+    /** Numeric field */
+    number(label) {
+        return new FieldDef('number', label);
+    }
+    /** Boolean field */
+    boolean(label) {
+        return new FieldDef('boolean', label);
+    }
+    /** Date field — automatically hints YYYY-MM-DD format */
+    date(label) {
+        return new FieldDef('date', label);
+    }
+    /** Timestamp field — ISO datetime */
+    timestamp(label) {
+        return new FieldDef('timestamp', label);
+    }
+    /** UUID field — string with UUID semantics */
+    uuid(label) {
+        return new FieldDef('uuid', label);
+    }
+    /** ID field — always required, numeric */
+    id(label) {
+        return new FieldDef('id', label);
+    }
+    /** Enum field — Django-style choices, tells AI valid values */
+    enum(label, values) {
+        return new FieldDef('enum', label, { enumValues: values });
+    }
+    /** Nested object field */
+    object(label, shape) {
+        return new FieldDef('object', label, { shape });
+    }
+    /** Array of objects field */
+    list(label, shape) {
+        return new FieldDef('list', label, { shape });
+    }
+    // ── Configuration Methods (Laravel-style) ───────────
+    /** Define field types and labels — like Laravel's `$casts` */
+    casts(fields) {
+        this._fields = { ...this._fields, ...fields };
+    }
+    /** Add created_at + updated_at timestamp fields — like Laravel's `timestamps()` */
+    timestamps() {
+        this._fields['created_at'] = new FieldDef('timestamp', 'Creation timestamp');
+        this._fields['updated_at'] = new FieldDef('timestamp', 'Last update timestamp');
+    }
+    /** Fields hidden from output — like Spring's `@JsonIgnore` or Laravel's `$hidden` */
+    hidden(fields) {
+        this._hidden = fields;
+    }
+    /** Fields that can NEVER be input — like Rails' `attr_protected` or Laravel's `$guarded` */
+    guarded(fields) {
+        this._guarded = fields;
+    }
+    /** Define input profiles per operation — like Laravel's `$fillable` + NestJS DTOs */
+    fillable(profiles) {
+        this._fillableProfiles = profiles;
+    }
+    // ── Compile ─────────────────────────────────────────
+    /** @internal Compile all fields into a Zod schema */
+    _compile() {
+        const shape = {};
+        const defaults = {};
+        for (const [name, def] of Object.entries(this._fields)) {
+            shape[name] = compileField(def);
+            if (def._defaultValue !== undefined) {
+                defaults[name] = def._defaultValue;
+            }
+        }
+        return { schema: z.object(shape), defaults };
+    }
+}
+// ── Factory ─────────────────────────────────────────────
+/**
+ * Define a Model — one file, one entity, one source of truth.
+ *
+ * @param name - Model name (e.g. 'Task', 'Sprint', 'Project')
+ * @param configure - Closure function that receives a `ModelBuilder` (`m`)
+ * @returns Compiled `Model` with `.schema`, `.fields`, `.input`, `.hidden`, `.guarded`
+ */
+export function defineModel(name, configure) {
+    const builder = new ModelBuilder();
+    configure(builder);
+    const { schema, defaults } = builder._compile();
+    // Pre-compute alias map at definition time (not per-call)
+    const aliasMap = new Map();
+    for (const [fieldName, fieldDef] of Object.entries(builder._fields)) {
+        if (fieldDef._alias) {
+            aliasMap.set(fieldName, fieldDef._alias);
+        }
+    }
+    const toApi = (data) => {
+        const result = {};
+        for (const [k, v] of Object.entries(data)) {
+            if (v !== undefined) {
+                result[aliasMap.get(k) ?? k] = v;
+            }
+        }
+        return result;
+    };
+    return Object.freeze({
+        name,
+        schema,
+        fields: Object.freeze(builder._fields),
+        hidden: Object.freeze(builder._hidden),
+        guarded: Object.freeze(builder._guarded),
+        input: Object.freeze(builder._fillableProfiles),
+        defaults: Object.freeze(defaults),
+        toApi,
+        infer: undefined,
+    });
+}
+//# sourceMappingURL=defineModel.js.map

package/dist/model/defineModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModel.js","sourceRoot":"","sources":["../../src/model/defineModel.ts"],"names":[],"mappings":"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"}

package/dist/model/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Model Layer — Barrel Export
+ *
+ * @module
+ */
+export { defineModel, FieldDef, ModelBuilder, compileFieldForInput } from './defineModel.js';
+export type { Model } from './defineModel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,7 @@
+/**
+ * Model Layer — Barrel Export
+ *
+ * @module
+ */
+export { defineModel, FieldDef, ModelBuilder, compileFieldForInput } from './defineModel.js';
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/observability/TelemetryBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TelemetryBus.d.ts","sourceRoot":"","sources":["../../src/observability/TelemetryBus.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkCzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7D;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDpF;AA2ED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqKnG"}
+{"version":3,"file":"TelemetryBus.d.ts","sourceRoot":"","sources":["../../src/observability/TelemetryBus.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkCzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7D;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDpF;AA2ED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAsKnG"}

package/dist/observability/TelemetryBus.js

@@ -326,6 +326,18 @@ export async function createTelemetryBus(config) {
         });
     });
     // ── Start Listening ───────────────────────────────────
+    // Bug #7 fix: chmod inside the listen callback to eliminate the race
+    // window where the socket is world-readable before permissions are set.
+    const chmodSocket = () => {
+        if (platform() !== 'win32') {
+            try {
+                chmodSync(socketPath, 0o600);
+            }
+            catch {
+                process.stderr.write('[vurb] Warning: Could not restrict socket permissions.\n');
+            }
+        }
+    };
     await new Promise((resolve, reject) => {
         server.once('error', (err) => {
             if (err.code === 'EADDRINUSE') {
@@ -337,27 +349,16 @@ export async function createTelemetryBus(config) {
                 }
                 catch { /* ignore on Windows */ }
                 server.once('error', (retryErr) => reject(retryErr));
-                server.listen(socketPath, () => resolve());
+                server.listen(socketPath, () => { chmodSocket(); resolve(); });
             }
             else {
                 reject(err);
             }
         });
-        server.listen(socketPath, () => resolve());
+        server.listen(socketPath, () => { chmodSocket(); resolve(); });
     });
     // ── Registry: announce this server for auto-discovery ──
     writeRegistryFile(process.pid, config?.path ? undefined : 'vurb');
-    // ── Gotcha #1: IPC Security (chmod 0o600) ─────────────
-    // Restrict socket to owner-only on POSIX to prevent PII sniffing
-    if (platform() !== 'win32') {
-        try {
-            chmodSync(socketPath, 0o600);
-        }
-        catch {
-            // Non-fatal — log warning via stderr (never stdout!)
-            process.stderr.write('[vurb] Warning: Could not restrict socket permissions.\n');
-        }
-    }
     // ── Heartbeat Timer ───────────────────────────────────
     const heartbeatTimer = setInterval(() => {
         if (clients.size === 0)