@makaio/framework 1.0.0-dev-1779051654000 → 1.0.0-dev-1781023871421

package/dist/core/index.d.mts

@@ -1,7 +1,7 @@
 import { ZodType, z } from "zod";
 import { Paths, Simplify, UnknownRecord } from "type-fest";
 
-//#region packages/makaio-core/src/types/config-storage.d.ts
+//#region core/makaio-core/src/types/config-storage.d.ts
 /**
  * Storage interface for config persistence.
  *
@@ -46,7 +46,7 @@ interface IConfigStorage<TConfig = unknown> {
   saveConfig(config: TConfig): Promise<void>;
 }
 //#endregion
-//#region packages/makaio-core/src/types/message.d.ts
+//#region core/makaio-core/src/types/message.d.ts
 /**
  * Host-agnostic principal attached by a trusted local transport.
  *
@@ -92,6 +92,18 @@ interface TransportReceiveContext {
   /** Optional host-agnostic principal resolved for this connection. */
   readonly principal?: PrincipalContext;
 }
+/**
+ * Describes the call origin of a bus message.
+ *
+ * Set on every context before handlers run; never serialized to wire.
+ * Derivation: `local` is `true` when no transport received the message
+ * (the call originated in this process), `false` when it arrived over
+ * a transport from a remote peer.
+ */
+interface MessageOrigin {
+  /** Whether the message originated locally (not from a remote transport). */
+  readonly local: boolean;
+}
 /**
  * Base message context interface for both events and requests.
  *
@@ -143,6 +155,16 @@ interface BaseMessageContext {
    * context. Never trust similarly named fields in payloads or wire messages.
    */
   transport?: TransportReceiveContext;
+  /**
+   * Where this message originated.
+   *
+   * `local: true` — emitted in this process.
+   * `local: false` — arrived via a transport from a remote caller.
+   *
+   * Always present; never serialized to the wire. Location-sensitive handlers
+   * check this before executing local side-effects.
+   */
+  origin: MessageOrigin;
   isRequest: boolean;
 }
 type EventMessagePayload<Payload extends UnknownRecord = UnknownRecord> = Payload & {
@@ -155,7 +177,7 @@ type RequestMessagePayload<Request extends UnknownRecord = UnknownRecord, Respon
 };
 type MessagePayload = RequestMessagePayload | EventMessagePayload;
 //#endregion
-//#region packages/makaio-core/src/types/context.d.ts
+//#region core/makaio-core/src/types/context.d.ts
 /**
  * Context object passed to event handlers when using wildcard patterns.
  *
@@ -182,6 +204,7 @@ interface EventContext<Payload> extends BaseMessageContext {
  * - `next`: Function to call the next handler in the middleware chain
  * - `replacePayload`: Function to transform the payload for subsequent handlers
  * - `identify`: Optional function to identify the handler for broadcast aggregation
+ * - `signal`: Optional AbortSignal from the originating request
  * - Message tracking fields from BaseMessage (messageId, correlationId)
  */
 interface RequestContext<Payload, Response> extends BaseMessageContext {
@@ -189,6 +212,8 @@ interface RequestContext<Payload, Response> extends BaseMessageContext {
   isRequest: true;
   /** The request payload */
   payload: Payload;
+  /** AbortSignal supplied by the originating request, if any. */
+  signal?: AbortSignal;
   /** Set the response value (ends the handler chain) */
   setResult: (result: Response) => void;
   /**
@@ -244,7 +269,7 @@ interface RequestContext<Payload, Response> extends BaseMessageContext {
  */
 type WildcardContext<Payload = unknown, Response = unknown> = EventContext<Payload> | RequestContext<Payload, Response>;
 //#endregion
-//#region packages/makaio-core/src/types/filter.d.ts
+//#region core/makaio-core/src/types/filter.d.ts
 type Primitive = string | number | boolean | null;
 /**
  * Filter operators for payload field matching.
@@ -320,7 +345,7 @@ declare function isOperatorObject(value: FilterOperator): value is {
   $endsWith: string;
 };
 //#endregion
-//#region packages/makaio-core/src/types/schema.d.ts
+//#region core/makaio-core/src/types/schema.d.ts
 /**
  * Schema definition for event subjects (fire-and-forget).
  * Events have only a payload schema, no response.
@@ -353,6 +378,17 @@ type LocalSubjectSchema<T extends EventSchema | RequestSchema = EventSchema | Re
   readonly __local: true;
   readonly schema: T;
 };
+/**
+ * Wrapper to mark an event subject as collector-only.
+ *
+ * Collector-only events may be received from a transport and delivered to local
+ * handlers, but the receiving bus must not relay them onward to other
+ * transports. Local emits are also kept local.
+ */
+type CollectorOnlySubjectSchema<T extends EventSchema = EventSchema> = {
+  readonly __collectorOnly: true;
+  readonly schema: T;
+};
 /**
  * Wrapper to mark a subject as channel-only (encrypted point-to-point).
  *
@@ -376,31 +412,46 @@ type ChannelSubjectSchema<T extends EventSchema | RequestSchema = EventSchema |
   readonly __channel: true;
   readonly schema: T;
 };
+/**
+ * Wrapper to set a subject-level default transport routing policy.
+ *
+ * This is weaker than `localSubject()`: the subject remains routable remotely,
+ * but local callers that omit an explicit `transports` option use this default.
+ */
+type DefaultTransportsSubjectSchema<T extends EventSchema | RequestSchema = EventSchema | RequestSchema, Default extends TransportRoutingDefault = TransportRoutingDefault> = {
+  readonly __defaultTransports: Default;
+  readonly schema: T;
+};
 /**
  * Base schema types (unwrapped).
  */
 type BaseSubjectSchema = EventSchema | RequestSchema;
 /**
- * Union of all subject schema types (including local and channel wrappers).
+ * Union of all subject schema types (including metadata wrappers).
  */
-type SubjectSchema = BaseSubjectSchema | LocalSubjectSchema | ChannelSubjectSchema;
+type SubjectSchema = BaseSubjectSchema | LocalSubjectSchema | CollectorOnlySubjectSchema | ChannelSubjectSchema | DefaultTransportsSubjectSchema;
 type SchemaRecord = Record<string, SubjectSchema>;
 //#endregion
-//#region packages/makaio-core/src/types/type-helpers.d.ts
+//#region core/makaio-core/src/types/type-helpers.d.ts
 /**
- * Unwrap LocalSubjectSchema or ChannelSubjectSchema wrappers if present.
- * Returns the inner schema for wrapped subjects, or the schema as-is otherwise.
+ * Unwrap subject schema wrappers if present. Returns the inner schema for
+ * wrapped subjects, or the schema as-is otherwise.
  */
 type UnwrapSchema<S> = S extends {
   readonly __local: true;
   readonly schema: infer Inner;
+} ? Inner : S extends {
+  readonly __collectorOnly: true;
+  readonly schema: infer Inner;
 } ? Inner : S extends {
   readonly __channel: true;
   readonly schema: infer Inner;
+} ? Inner : S extends {
+  readonly __defaultTransports: TransportRoutingDefault;
+  readonly schema: infer Inner;
 } ? Inner : S;
 /**
- * Infer payload type from schema (handles EventSchema, RequestSchema,
- * LocalSubjectSchema, and ChannelSubjectSchema).
+ * Infer payload type from schema, including subject metadata wrappers.
  *
  * For requests:
  * - Uses z.input for request (what callers pass before validation/defaults)
@@ -409,8 +460,7 @@ type UnwrapSchema<S> = S extends {
  * This allows schemas with .default() to have optional fields in the caller API
  * while the response type reflects the validated output.
  *
- * LocalSubjectSchema and ChannelSubjectSchema wrappers are automatically
- * unwrapped before inference.
+ * Subject schema wrappers are automatically unwrapped before inference.
  *
  * Idempotent: Returns already-inferred types as-is.
  */
@@ -426,7 +476,7 @@ type InferSchemaPayloadInner<S> = S extends {
  * Compute all subject meta from the original schema in one place.
  *
  * Resolves payload, locality, channel membership, request/event discriminator,
- * and namespace from a raw SubjectSchema.
+ * default transport routing, and namespace from a raw SubjectSchema.
  * @typeParam S - The subject schema type
  * @typeParam Ns - The namespace string
  */
@@ -439,10 +489,23 @@ type InferSubjectMeta<S extends SubjectSchema, Ns extends string> = {
   channel: S extends ChannelSubjectSchema ? true : false; /** Inferred payload type (request/response pair or event payload). */
   payload: InferSchemaPayload<S>; /** The namespace this subject belongs to. */
   namespace: Ns;
-};
+} & (S extends DefaultTransportsSubjectSchema<EventSchema | RequestSchema, infer Default> ? {
+  defaultTransports: Default;
+} : {
+  defaultTransports?: TransportRoutingDefault;
+});
 //#endregion
-//#region packages/makaio-core/src/types/subjects.d.ts
+//#region core/makaio-core/src/types/subjects.d.ts
 type SubjectRecord<SubjectKeys extends string = string, Payload extends MessagePayload = MessagePayload> = Record<SubjectKeys, Payload>;
+/**
+ * Default transport routing semantics for a subject or namespace.
+ *
+ * - `'all'` — send to all registered transports (the default when omitted).
+ * - `'local-only'` — suppress outbound transport fan-out unless the caller
+ *   explicitly provides a `transports` override. Weaker than `localSubject()`:
+ *   the subject can still be invoked remotely.
+ */
+type TransportRoutingDefault = 'all' | 'local-only';
 type SubjectRecordFromSchemaRecord<SchemaRecord extends Record<string, SubjectSchema>> = { [K in keyof SchemaRecord & string]: Simplify<InferSchemaPayload<SchemaRecord[K]>> };
 type SubjectDefinitionMeta<Subject extends SubjectRecord = SubjectRecord<'default'>, K extends keyof Subject = keyof Subject, Namespace extends string = string> = {
   isRequest: Subject extends SubjectRecord<'default'> ? boolean : Subject[K] extends RequestMessagePayload ? true : false;
@@ -458,6 +521,17 @@ type SubjectDefinitionMeta<Subject extends SubjectRecord = SubjectRecord<'defaul
    * DirectChannel encrypted point-to-point transport.
    */
   channel: boolean;
+  /**
+   * Default transport routing for bus calls on this subject when the caller
+   * does not provide an explicit `transports` option.
+   *
+   * - `'all'` (default) — send to all registered transports as usual.
+   * - `'local-only'` — suppress transport fan-out unless the caller explicitly
+   *   provides a `transports` override. Weaker than `localSubject()`: the
+   *   subject can still be invoked remotely; only the outbound default is
+   *   suppressed.
+   */
+  defaultTransports?: TransportRoutingDefault;
 };
 type SubjectDefinition<Subject extends SubjectRecord = SubjectRecord, SubjectKey extends keyof Subject = keyof Subject, Namespace extends string = string> = {
   $meta: SubjectDefinitionMeta<Subject, SubjectKey, Namespace>;
@@ -526,12 +600,12 @@ type FilterablePayloadIntersection<Subjects extends SubjectRecord> = Simplify<Al
  */
 type FilterPayloadFromSchemas<Schemas extends Record<string, SubjectSchema>> = Simplify<AllPropertiesOfUnion<{ [K in keyof Schemas]: FilterablePayload<InferSchemaPayload<Schemas[K]>> }[keyof Schemas]>>;
 //#endregion
-//#region packages/makaio-core/src/types/wildcards.d.ts
+//#region core/makaio-core/src/types/wildcards.d.ts
 type WildcardSubject = '*';
 declare const WildcardSubjectKey = "*";
 type WildcardSubjectDefinition<Namespace extends string = string> = SubjectDefinition<Record<'*', MessagePayload>, WildcardSubject, Namespace>;
 //#endregion
-//#region packages/makaio-core/src/types/handler-types.d.ts
+//#region core/makaio-core/src/types/handler-types.d.ts
 type EventHandler<T> = (context: EventContext<T>) => void | Promise<void>;
 type RequestHandler<Payload, Response> = (context: RequestContext<Payload, Response>) => void | Promise<void>;
 /**
@@ -599,7 +673,7 @@ type HandlerForSubjectDefinition<T extends SubjectDefinition> = T['subject'] ext
  */
 type ContextForSubjectDefinition<T extends SubjectDefinition> = T['subject'] extends WildcardSubject ? WildcardContext<unknown, unknown> : T['$meta']['payload'] extends RequestMessagePayload<infer Request, infer Response> ? RequestContext<Request, Response> : T['$meta']['payload'] extends EventMessagePayload<infer Payload> ? EventContext<Payload> : never;
 //#endregion
-//#region packages/makaio-core/src/types/result.d.ts
+//#region core/makaio-core/src/types/result.d.ts
 /**
  * Result types for optional request handling.
  *
@@ -628,7 +702,7 @@ type OptionalResult<T> = {
   handled: false;
 };
 //#endregion
-//#region packages/makaio-core/src/types/bus-like.d.ts
+//#region core/makaio-core/src/types/bus-like.d.ts
 type EventSubjectLike = SubjectDefinition & {
   readonly $meta: {
     readonly isRequest: false;
@@ -656,7 +730,7 @@ interface MakaioBusLike {
   request<Subject extends RequestSubjectLike>(subject: Subject, payload: Subject['$meta']['payload']['request']): Promise<Subject['$meta']['payload']['response']>;
 }
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/nest-subject-definitions.d.ts
+//#region core/makaio-core/src/subject-helpers/nest-subject-definitions.d.ts
 /**
  * Recursively nests a flat record of dotted keys into a hierarchical object type.
  *
@@ -702,9 +776,12 @@ type BusSubjects<RecordOfSubjectDefinitions extends Record<string, unknown> = Re
  * Nests flat dotted subject keys into a hierarchical structure.
  * @param namespace - The domain/namespace for the subject definitions
  * @param flat - Flat record of subject schemas with dotted keys
+ * @param namespaceDefaultTransports - Optional namespace-level transport default
+ *   propagated to each subject's `$meta.defaultTransports` unless the subject
+ *   schema is wrapped with `defaultTransports()`.
  * @returns Nested subject definitions with hierarchical structure and a $all wildcard
  */
-declare function nestSubjectDefinitions<Domain extends string, T extends Record<string, SubjectSchema>>(namespace: Domain, flat: T): NestedSubjectDefinitions<FlatSubjectDefinitions<Domain, T>> & {
+declare function nestSubjectDefinitions<Domain extends string, T extends Record<string, SubjectSchema>>(namespace: Domain, flat: T, namespaceDefaultTransports?: TransportRoutingDefault): NestedSubjectDefinitions<FlatSubjectDefinitions<Domain, T>> & {
   $all: WildcardSubjectDefinition<Domain>;
 };
 /**
@@ -714,7 +791,7 @@ declare function nestSubjectDefinitions<Domain extends string, T extends Record<
  */
 declare function getFullSubjectForSubjectDefinition(subject: SubjectDefinition): string;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-request-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-request-schema.d.ts
 /**
  * Type guard to check if a schema is a request schema.
  * @param schema - The schema to check
@@ -722,7 +799,7 @@ declare function getFullSubjectForSubjectDefinition(subject: SubjectDefinition):
  */
 declare function isRequestSchema(schema: SubjectSchema): schema is RequestSchema;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-local-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-local-schema.d.ts
 /**
  * Check if a schema is wrapped as a local subject.
  * @param schema - The schema to check
@@ -755,7 +832,25 @@ declare function isLocalSchema(schema: SubjectSchema): schema is LocalSubjectSch
  */
 declare function localSubject<T extends EventSchema | RequestSchema>(schema: T): LocalSubjectSchema<T>;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-channel-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-collector-only-schema.d.ts
+/**
+ * Check if a schema is wrapped as a collector-only subject.
+ * @param schema - The schema to check.
+ * @returns True if the schema is a CollectorOnlySubjectSchema wrapper.
+ */
+declare function isCollectorOnlySchema(schema: SubjectSchema): schema is CollectorOnlySubjectSchema;
+/**
+ * Create a collector-only event schema wrapper.
+ *
+ * Collector-only events are transport-ingestable but not transport-relayable:
+ * a collector bus can receive them from an upstream peer and handle them
+ * locally without pushing them laterally to unrelated peers.
+ * @param schema - The event schema to mark as collector-only.
+ * @returns A CollectorOnlySubjectSchema wrapper.
+ */
+declare function collectorOnlySubject<T extends EventSchema>(schema: T): CollectorOnlySubjectSchema<T>;
+//#endregion
+//#region core/makaio-core/src/subject-helpers/is-channel-schema.d.ts
 /**
  * Check if a schema is wrapped as a channel subject.
  * @param schema - The schema to check
@@ -788,16 +883,43 @@ declare function isChannelSchema(schema: SubjectSchema): schema is ChannelSubjec
  */
 declare function channelSubject<T extends EventSchema | RequestSchema>(schema: T): ChannelSubjectSchema<T>;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/unwrap-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/default-transports-schema.d.ts
+/**
+ * Check if a schema carries a subject-level default transport routing policy.
+ * @param schema - The schema to check
+ * @returns True if the schema is a DefaultTransportsSubjectSchema wrapper
+ */
+declare function isDefaultTransportsSchema(schema: SubjectSchema): schema is DefaultTransportsSubjectSchema;
+/**
+ * Create a subject schema wrapper with a subject-level default transport policy.
+ *
+ * Use this when one subject should override its namespace's default transport
+ * routing while still remaining remotely invokable when a caller explicitly
+ * targets a transport.
+ * @param schema - The event or request schema to wrap
+ * @param value - Default transport routing policy for this subject
+ * @returns A DefaultTransportsSubjectSchema wrapper
+ * @example
+ * ```typescript
+ * import { defaultTransports } from '@makaio/framework/core';
+ *
+ * const Schemas = {
+ *   internalEvent: defaultTransports(z.object({ id: z.string() }), 'local-only'),
+ * };
+ * ```
+ */
+declare function defaultTransports<T extends EventSchema | RequestSchema, Default extends TransportRoutingDefault>(schema: T, value: Default): DefaultTransportsSubjectSchema<T, Default>;
+//#endregion
+//#region core/makaio-core/src/subject-helpers/unwrap-schema.d.ts
 /**
- * Unwrap any subject schema wrapper (local or channel) to get the inner schema.
+ * Unwrap any subject schema wrapper to get the inner schema.
  * Returns the schema as-is if not wrapped.
  * @param schema - The schema to unwrap
  * @returns The inner EventSchema or RequestSchema
  */
 declare function unwrapSchema(schema: SubjectSchema): EventSchema | RequestSchema;
 //#endregion
-//#region packages/makaio-core/src/bus-namespace-definition.d.ts
+//#region core/makaio-core/src/bus-namespace-definition.d.ts
 /**
  * Report passed to the {@link NamespaceRegistrationOptions} `onSchemaViolation` callback
  * when lenient validation detects a schema mismatch.
@@ -854,6 +976,19 @@ interface BusNamespaceDefinition<Domain extends string = string, Schemas extends
   readonly schemas: Schemas;
   /** Registration options (validation mode, violation callback) */
   readonly options?: NamespaceRegistrationOptions;
+  /**
+   * Default transport routing for all subjects in this namespace when the
+   * caller does not provide an explicit `transports` option.
+   *
+   * Subject-level `defaultTransports` (set via `SubjectDefinitionMeta`) takes
+   * precedence over this namespace-level default when both are set.
+   *
+   * - `'all'` (default when omitted) — send to all registered transports.
+   * - `'local-only'` — suppress outbound transport fan-out by default. Callers
+   *   can still force transport delivery by passing an explicit `transports`
+   *   option. Weaker than `localSubject()`: subjects remain reachable remotely.
+   */
+  readonly defaultTransports?: TransportRoutingDefault;
   /**
    * Phantom field for type inference of filterable payload shape.
    *
@@ -877,6 +1012,26 @@ interface BusNamespaceDefinition<Domain extends string = string, Schemas extends
 type RegistrableBusNamespaceDefinition = Omit<BusNamespaceDefinition, 'subjects' | '__filterPayload'> & {
   /** Runtime subject token tree created by `createBusNamespace`. */readonly subjects: unknown;
 };
+/**
+ * Options for {@link createBusNamespace}.
+ *
+ * Extends each variant of {@link NamespaceRegistrationOptions} with an optional
+ * `defaultTransports` field so callers can pass both validation mode and routing
+ * default in a single options object.
+ */
+type CreateBusNamespaceOptions = NamespaceRegistrationOptions & {
+  /**
+   * Default transport routing for every subject in this namespace when the
+   * caller does not provide an explicit `transports` option.
+   *
+   * Subject-level `defaultTransports` (set via `SubjectDefinitionMeta`) takes
+   * precedence over this namespace-level default when both are set.
+   *
+   * - `'all'` (default when omitted) — send to all registered transports.
+   * - `'local-only'` — suppress outbound transport fan-out by default.
+   */
+  defaultTransports?: TransportRoutingDefault;
+};
 /**
  * Creates a bus namespace definition with typed subject tokens.
  *
@@ -886,7 +1041,7 @@ type RegistrableBusNamespaceDefinition = Omit<BusNamespaceDefinition, 'subjects'
  * `MakaioBus.registerNamespace(definition)`.
  * @param name - Namespace domain string (e.g., `'adapter'`, `'session'`)
  * @param schemas - Schema record mapping subject keys to Zod schemas
- * @param options - Optional registration options (validation mode, violation callback)
+ * @param options - Optional registration and routing options
  * @returns Namespace definition with typed subject tokens and carried schemas
  * @example
  * ```typescript
@@ -897,9 +1052,9 @@ type RegistrableBusNamespaceDefinition = Omit<BusNamespaceDefinition, 'subjects'
  * export const AdapterSubjects = AdapterNamespace.subjects;
  * ```
  */
-declare function createBusNamespace<Domain extends string, Schemas extends Record<string, SubjectSchema>>(name: Domain, schemas: Schemas, options?: NamespaceRegistrationOptions): BusNamespaceDefinition<Domain, Schemas>;
+declare function createBusNamespace<Domain extends string, Schemas extends Record<string, SubjectSchema>>(name: Domain, schemas: Schemas, options?: CreateBusNamespaceOptions): BusNamespaceDefinition<Domain, Schemas>;
 //#endregion
-//#region packages/makaio-core/src/context/index.d.ts
+//#region core/makaio-core/src/context/index.d.ts
 /**
  * Platform identifier for tool execution context.
  * Used to determine platform-specific behavior in tools.
@@ -961,7 +1116,7 @@ interface MakaioContext {
  */
 declare function createMakaioContext(overrides?: Partial<MakaioContext>): MakaioContext;
 //#endregion
-//#region packages/makaio-core/src/errors/index.d.ts
+//#region core/makaio-core/src/errors/index.d.ts
 /**
  * Base error class for all Makaio-related errors.
  */
@@ -998,4 +1153,111 @@ declare class QuotaExceededError extends MakaioError {
   readonly code: "quota_exceeded";
 }
 //#endregion
-export { type AnyHandler, type AnyMessageContext, AuthenticationError, type BaseSubjectSchema, type BusNamespaceDefinition, type BusSubjects, type ChannelSubjectSchema, ConfigError, type ContextForSubjectDefinition, DirectoryNotFoundError, type EventContext, type EventHandler, type EventMessagePayload, type EventSchema, type ExtractSubjectPayload, type ExtractSubjectResponse, type FilterOperator, type FilterPayloadFromSchemas, type FilterablePayloadIntersection, type FlatSubjectDefinitions, type HandlerForSubjectDefinition, type IConfigStorage, type InferSchemaPayload, type InferSubjectMeta, InvalidModelError, type LocalSubjectSchema, type MakaioBusLike, type MakaioContext, MakaioError, type MessagePayload, ModelUnavailableError, type NamespaceRegistrationOptions, type NestedSubjectDefinitions, type OptionalResult, type PayloadFilter, type PrincipalContext, QuotaExceededError, RateLimitError, type RegistrableBusNamespaceDefinition, type RequestContext, type RequestHandler, type RequestMessagePayload, type RequestSchema, type SchemaRecord, type SchemaViolationReport, type ScopedSubjectDefinition, type SubjectDefinition, type SubjectRecord, type SubjectRecordFromSchemaRecord, type SubjectSchema, type TransportPeerContext, type TransportReceiveContext, type TypedPayloadFilter, type WildcardContext, type WildcardSubject, type WildcardSubjectDefinition, WildcardSubjectKey, type WildcardUnifiedHandler, channelSubject, createBusNamespace, createMakaioContext, getFullSubjectForSubjectDefinition, isChannelSchema, isLocalSchema, isOperatorObject, isRequestSchema, localSubject, nestSubjectDefinitions, unwrapSchema };
+//#region core/makaio-core/src/observability/schema-observability.d.ts
+/**
+ * Zod metadata key under which observability policies are stored.
+ *
+ * Using a namespaced string key avoids collisions with any other metadata
+ * that callers attach to a schema via `.meta()`.
+ */
+declare const OBSERVABILITY_META_KEY = "makaio.observability";
+/**
+ * Schema-level observability policy attached to a Zod object schema via
+ * {@link observability.schema}.
+ */
+interface ObservabilitySchemaPolicy {
+  /**
+   * When `true`, all scalar fields of the schema are projected to telemetry
+   * unless a field opts out with `visibility: 'hidden'`.
+   */
+  readonly traceAll?: boolean;
+}
+/** Controls how a single field participates in subject telemetry projection. */
+type ObservabilityFieldVisibility = 'attribute' | 'hidden' | 'count';
+/**
+ * Field-level observability policy attached to a Zod field schema via
+ * {@link observability.field}, {@link observability.hidden},
+ * {@link observability.count}, or {@link observability.attribute}.
+ */
+interface ObservabilityFieldPolicy {
+  /** How this field participates in subject telemetry projection. */
+  readonly visibility: ObservabilityFieldVisibility;
+  /**
+   * Telemetry attribute name for this field.
+   * Defaults to the object property key when absent.
+   */
+  readonly attributeName?: string;
+}
+/**
+ * Returns the {@link ObservabilitySchemaPolicy} stored on a schema, or
+ * `undefined` if the schema has no schema-level observability metadata.
+ * @param schema - The Zod schema to inspect.
+ * @returns The schema-level observability policy, or `undefined`.
+ */
+declare function getObservabilitySchemaPolicy(schema: z.ZodType): ObservabilitySchemaPolicy | undefined;
+/**
+ * Returns the {@link ObservabilityFieldPolicy} stored on a field schema, or
+ * `undefined` if no field-level observability metadata is found.
+ *
+ * The lookup walks transparent wrapper layers from outermost to innermost so
+ * wrapper-level metadata can override inner metadata, and metadata attached to
+ * any intermediate wrapper remains readable after additional wrapping.
+ * @param schema - The Zod field schema to inspect.
+ * @returns The field-level observability policy, or `undefined`.
+ */
+declare function getObservabilityFieldPolicy(schema: z.ZodType): ObservabilityFieldPolicy | undefined;
+/**
+ * Fluent helpers for attaching observability metadata to Zod schemas.
+ *
+ * All methods return a new schema instance — Zod schemas are immutable. The
+ * original schema is never mutated.
+ * @example
+ * ```typescript
+ * const RequestSchema = observability.schema(
+ *   z.object({ query: z.string(), limit: z.number() }),
+ *   { traceAll: true },
+ * );
+ *
+ * const HiddenField = observability.hidden(z.string()).optional();
+ * ```
+ */
+declare const observability: {
+  /**
+   * Attaches a schema-level {@link ObservabilitySchemaPolicy} to a Zod schema.
+   * Preserves any metadata already present on the schema.
+   * @param schema - The Zod schema to annotate.
+   * @param policy - The schema-level observability policy to store.
+   * @returns A new schema instance with the policy merged into its metadata.
+   */
+  schema<TSchema extends z.ZodType>(schema: TSchema, policy: ObservabilitySchemaPolicy): TSchema;
+  /**
+   * Attaches a field-level {@link ObservabilityFieldPolicy} to a Zod schema.
+   * Preserves any metadata already present on the schema.
+   * @param schema - The Zod field schema to annotate.
+   * @param policy - The field-level observability policy to store.
+   * @returns A new schema instance with the policy merged into its metadata.
+   */
+  field<TSchema extends z.ZodType>(schema: TSchema, policy: ObservabilityFieldPolicy): TSchema;
+  /**
+   * Marks a field as hidden from subject telemetry projection.
+   * @param schema - The Zod field schema to hide.
+   * @returns A new schema instance with `visibility: 'hidden'` stored in its metadata.
+   */
+  hidden<TSchema extends z.ZodType>(schema: TSchema): TSchema;
+  /**
+   * Marks a field to be projected as a count metric in subject telemetry.
+   * @param schema - The Zod field schema to count.
+   * @param attributeName - Optional telemetry attribute name override.
+   * @returns A new schema instance with `visibility: 'count'` stored in its metadata.
+   */
+  count<TSchema extends z.ZodType>(schema: TSchema, attributeName?: string): TSchema;
+  /**
+   * Marks a field to be projected as a named attribute in subject telemetry.
+   * @param schema - The Zod field schema to expose as an attribute.
+   * @param attributeName - Optional telemetry attribute name override.
+   * @returns A new schema instance with `visibility: 'attribute'` stored in its metadata.
+   */
+  attribute<TSchema extends z.ZodType>(schema: TSchema, attributeName?: string): TSchema;
+};
+//#endregion
+export { type AnyHandler, type AnyMessageContext, AuthenticationError, type BaseMessageContext, type BaseSubjectSchema, type BusNamespaceDefinition, type BusSubjects, type ChannelSubjectSchema, type CollectorOnlySubjectSchema, ConfigError, type ContextForSubjectDefinition, type CreateBusNamespaceOptions, type DefaultTransportsSubjectSchema, DirectoryNotFoundError, type EventContext, type EventHandler, type EventMessagePayload, type EventSchema, type ExtractSubjectPayload, type ExtractSubjectResponse, type FilterOperator, type FilterPayloadFromSchemas, type FilterablePayloadIntersection, type FlatSubjectDefinitions, type HandlerForSubjectDefinition, type IConfigStorage, type InferSchemaPayload, type InferSubjectMeta, InvalidModelError, type LocalSubjectSchema, type MakaioBusLike, type MakaioContext, MakaioError, type MessageOrigin, type MessagePayload, ModelUnavailableError, type NamespaceRegistrationOptions, type NestedSubjectDefinitions, OBSERVABILITY_META_KEY, type ObservabilityFieldPolicy, type ObservabilityFieldVisibility, type ObservabilitySchemaPolicy, type OptionalResult, type PayloadFilter, type PrincipalContext, QuotaExceededError, RateLimitError, type RegistrableBusNamespaceDefinition, type RequestContext, type RequestHandler, type RequestMessagePayload, type RequestSchema, type SchemaRecord, type SchemaViolationReport, type ScopedSubjectDefinition, type SubjectDefinition, type SubjectRecord, type SubjectRecordFromSchemaRecord, type SubjectSchema, type TransportPeerContext, type TransportReceiveContext, type TransportRoutingDefault, type TypedPayloadFilter, type WildcardContext, type WildcardSubject, type WildcardSubjectDefinition, WildcardSubjectKey, type WildcardUnifiedHandler, channelSubject, collectorOnlySubject, createBusNamespace, createMakaioContext, defaultTransports, getFullSubjectForSubjectDefinition, getObservabilityFieldPolicy, getObservabilitySchemaPolicy, isChannelSchema, isCollectorOnlySchema, isDefaultTransportsSchema, isLocalSchema, isOperatorObject, isRequestSchema, localSubject, nestSubjectDefinitions, observability, unwrapSchema };

package/dist/core/index.mjs

@@ -1 +1 @@
-import{z as e}from"zod";function t(e){if(typeof e!=`object`||!e)return!1;let t=e;return`$in`in t||`$ne`in t||`$exists`in t||`$startsWith`in t||`$endsWith`in t}const n=`*`;function r(t){return typeof t==`object`&&!!t&&`request`in t&&`response`in t&&t.request instanceof e.ZodType&&t.response instanceof e.ZodType}function i(e){return typeof e==`object`&&!!e&&`__channel`in e&&e.__channel===!0&&`schema`in e}function a(e){return{__channel:!0,schema:e}}function o(e){return typeof e==`object`&&!!e&&`__local`in e&&e.__local===!0&&`schema`in e}function s(e){return{__local:!0,schema:e}}function c(e){return o(e)||i(e)?e.schema:e}function l(e,t){let n={};for(let[a,s]of Object.entries(t)){let t=a.split(`.`),l=n;for(let e=0;e<t.length-1;e++)l[t[e]]??={},l=l[t[e]];let u=o(s),d=i(s),f={subject:a,$meta:{namespace:e,isRequest:r(c(s)),local:u,channel:d}};l[t[t.length-1]]=f}return n.$all={subject:`*`,$meta:{namespace:e,isRequest:!1,local:!1,channel:!1}},n}function u(e){return`${e.$meta.namespace}.${e.subject}`}function d(e,t,n){return{name:e,subjects:l(e,t),schemas:t,...n?{options:n}:{}}}e.object({cwd:e.string(),env:e.record(e.string(),e.string()),platform:e.enum([`posix`,`windows`]),signal:e.custom().optional(),constraints:e.record(e.string(),e.unknown()).optional(),sessionId:e.string().optional(),subagentId:e.string().optional(),subagentDepth:e.number().optional()});function f(){return typeof process>`u`?`posix`:process.platform===`win32`?`windows`:`posix`}const p=[`API_KEY`,`APIKEY`,`SECRET`,`TOKEN`,`PASSWORD`,`CREDENTIAL`,`PRIVATE_KEY`,`PRIVATEKEY`,`AUTH`,`BEARER`,`ACCESS_KEY`,`ACCESSKEY`];function m(e){let t=e.toUpperCase();return p.some(e=>t.includes(e))}function h(e){let t={};for(let[n,r]of Object.entries(e))r!==void 0&&!m(n)&&(t[n]=r);return t}function g(e){let t=typeof process<`u`?process.cwd():`/`,n=typeof process<`u`?h(process.env):{};return{cwd:e?.cwd??t,env:e?.env??n,platform:e?.platform??f(),signal:e?.signal,constraints:e?.constraints,sessionId:e?.sessionId,subagentId:e?.subagentId,subagentDepth:e?.subagentDepth}}var _=class extends Error{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},v=class extends _{subject;constructor(e,t){super(`Invalid model specified: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},y=class extends _{subject;constructor(e,t){super(`Directory does not exist: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},b=class extends _{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},x=class extends _{code=`rate_limit`},S=class extends _{code=`auth`},C=class extends _{code=`model_unavailable`},w=class extends _{code=`quota_exceeded`};export{S as AuthenticationError,b as ConfigError,y as DirectoryNotFoundError,v as InvalidModelError,_ as MakaioError,C as ModelUnavailableError,w as QuotaExceededError,x as RateLimitError,n as WildcardSubjectKey,a as channelSubject,d as createBusNamespace,g as createMakaioContext,u as getFullSubjectForSubjectDefinition,i as isChannelSchema,o as isLocalSchema,t as isOperatorObject,r as isRequestSchema,s as localSubject,l as nestSubjectDefinitions,c as unwrapSchema};
+import{z as e}from"zod";function t(e){if(typeof e!=`object`||!e)return!1;let t=e;return`$in`in t||`$ne`in t||`$exists`in t||`$startsWith`in t||`$endsWith`in t}const n=`*`;function r(t){return typeof t==`object`&&!!t&&`request`in t&&`response`in t&&t.request instanceof e.ZodType&&t.response instanceof e.ZodType}function i(e){return typeof e==`object`&&!!e&&`__channel`in e&&e.__channel===!0&&`schema`in e}function a(e){return{__channel:!0,schema:e}}function o(e){return typeof e==`object`&&!!e&&`__local`in e&&e.__local===!0&&`schema`in e}function s(e){return{__local:!0,schema:e}}function c(e){return typeof e==`object`&&!!e&&`__defaultTransports`in e&&(e.__defaultTransports===`all`||e.__defaultTransports===`local-only`)&&`schema`in e}function l(e,t){return{__defaultTransports:t,schema:e}}function u(e){return typeof e==`object`&&!!e&&`__collectorOnly`in e&&e.__collectorOnly===!0&&`schema`in e}function d(e){return{__collectorOnly:!0,schema:e}}function f(e){return o(e)||u(e)||i(e)||c(e)?e.schema:e}function p(e,t,n){let a={};for(let[s,l]of Object.entries(t)){let t=s.split(`.`),u=a;for(let e=0;e<t.length-1;e++)u[t[e]]??={},u=u[t[e]];let d=o(l),p=i(l),m=c(l)?l.__defaultTransports:n,h={subject:s,$meta:{namespace:e,isRequest:r(f(l)),local:d,channel:p,...m!==void 0&&{defaultTransports:m}}};u[t[t.length-1]]=h}return a.$all={subject:`*`,$meta:{namespace:e,isRequest:!1,local:!1,channel:!1}},a}function m(e){return`${e.$meta.namespace}.${e.subject}`}function h(e,t,n){let r=n?.defaultTransports,i;if(n!==void 0){let{defaultTransports:e,...t}=n;i=Object.keys(t).length>0?t:void 0}return{name:e,subjects:p(e,t,r),schemas:t,...i===void 0?{}:{options:i},...r===void 0?{}:{defaultTransports:r}}}e.object({cwd:e.string(),env:e.record(e.string(),e.string()),platform:e.enum([`posix`,`windows`]),signal:e.custom().optional(),constraints:e.record(e.string(),e.unknown()).optional(),sessionId:e.string().optional(),subagentId:e.string().optional(),subagentDepth:e.number().optional()});function g(){return typeof process>`u`?`posix`:process.platform===`win32`?`windows`:`posix`}const _=[`API_KEY`,`APIKEY`,`SECRET`,`TOKEN`,`PASSWORD`,`CREDENTIAL`,`PRIVATE_KEY`,`PRIVATEKEY`,`AUTH`,`BEARER`,`ACCESS_KEY`,`ACCESSKEY`];function v(e){let t=e.toUpperCase();return _.some(e=>t.includes(e))}function y(e){let t={};for(let[n,r]of Object.entries(e))r!==void 0&&!v(n)&&(t[n]=r);return t}function b(e){let t=typeof process<`u`?process.cwd():`/`,n=typeof process<`u`?y(process.env):{};return{cwd:e?.cwd??t,env:e?.env??n,platform:e?.platform??g(),signal:e?.signal,constraints:e?.constraints,sessionId:e?.sessionId,subagentId:e?.subagentId,subagentDepth:e?.subagentDepth}}var x=class extends Error{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},S=class extends x{subject;constructor(e,t){super(`Invalid model specified: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},C=class extends x{subject;constructor(e,t){super(`Directory does not exist: ${e}`),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},w=class extends x{subject;constructor(e,t){super(e),this.subject=t,this.name=this.constructor.name,Error.captureStackTrace?.(this,this.constructor)}},T=class extends x{code=`rate_limit`},E=class extends x{code=`auth`},D=class extends x{code=`model_unavailable`},O=class extends x{code=`quota_exceeded`};const k=`makaio.observability`;function A(e){let t=e.meta()?.[k];if(typeof t!=`object`||!t)return;let n=t;return n.kind===`schema`||n.kind===`field`?n:void 0}function j(e,t){return e.meta({...e.meta(),[k]:t})}function M(t){if(t instanceof e.ZodOptional||t instanceof e.ZodNullable||t instanceof e.ZodDefault||t instanceof e.ZodCatch||t instanceof e.ZodReadonly)return t.unwrap()}function N(e){let t=e;for(;t;){let e=A(t);if(e?.kind===`field`)return e;t=M(t)}}function P(e){let t=A(e);if(t?.kind===`schema`)return{traceAll:t.traceAll}}function F(e){let t=N(e);if(t)return{visibility:t.visibility,attributeName:t.attributeName}}const I={schema(e,t){return j(e,{kind:`schema`,traceAll:t.traceAll})},field(e,t){return j(e,{kind:`field`,visibility:t.visibility,attributeName:t.attributeName})},hidden(e){return j(e,{kind:`field`,visibility:`hidden`})},count(e,t){return j(e,{kind:`field`,visibility:`count`,attributeName:t})},attribute(e,t){return j(e,{kind:`field`,visibility:`attribute`,attributeName:t})}};export{E as AuthenticationError,w as ConfigError,C as DirectoryNotFoundError,S as InvalidModelError,x as MakaioError,D as ModelUnavailableError,k as OBSERVABILITY_META_KEY,O as QuotaExceededError,T as RateLimitError,n as WildcardSubjectKey,a as channelSubject,d as collectorOnlySubject,h as createBusNamespace,b as createMakaioContext,l as defaultTransports,m as getFullSubjectForSubjectDefinition,F as getObservabilityFieldPolicy,P as getObservabilitySchemaPolicy,i as isChannelSchema,u as isCollectorOnlySchema,c as isDefaultTransportsSchema,o as isLocalSchema,t as isOperatorObject,r as isRequestSchema,s as localSubject,p as nestSubjectDefinitions,I as observability,f as unwrapSchema};

package/dist/{credential-ref-DLCsoKVZ.mjs → credential-ref-YWQQENEo.mjs}

@@ -1 +1 @@
-import"./visibility-CZu8ooOA.mjs";import{z as e}from"zod";const t=`stored:providerConfig:`,n=`account-manager:`;function r(e){if(!e.startsWith(t))return null;let n=e.slice(22),r=n.lastIndexOf(`:`);if(r===-1)return null;let i=n.slice(0,r),a=n.slice(r+1);return!i||!a||a.includes(`:`)?null:{configId:i,key:a}}function i(e,t){if(!e.startsWith(t))return!1;let n=e.slice(t.length),r=n.indexOf(`:`);return!(r<=0||r>=n.length-1)}function a(e){if(!e.startsWith(n))return null;try{let t=JSON.parse(e.slice(16));return!Array.isArray(t)||t.length!==2||typeof t[0]!=`string`||typeof t[1]!=`string`||t[0].length===0||t[1].length===0?null:{clientId:t[0],accountId:t[1]}}catch{return null}}function o(e){if(r(e))return!0;if(e.startsWith(`env:`)){let t=e.slice(4);return/^[A-Za-z_][A-Za-z0-9_]*$/.test(t)}return e.startsWith(`file:`)?e.length>5:!!(i(e,`keychain:`)||a(e))}function s(e){return a(e)!==null}const c=e.string().refine(o,{message:`Invalid credential reference format.`}).brand();function l(e,n){if(n.includes(`:`))throw Error(`Credential key must not contain colons: "${n}"`);return c.parse(`${t}${e}:${n}`)}function u(e,t){return c.parse(`${n}${JSON.stringify([e,t])}`)}function d(e){return r(e)}function f(e){if(!e)return;let t={};for(let[n,r]of Object.entries(e))t[n]=c.parse(r);return t}function p(e){if(e)return Object.fromEntries(Object.entries(e).map(([e,t])=>[e,t]))}export{s as a,l as i,f as n,d as o,u as r,p as s,c as t};
+import"./visibility-Cb62p9bv.mjs";import{z as e}from"zod";const t=`stored:providerConfig:`,n=`account-manager:`;function r(e){if(!e.startsWith(t))return null;let n=e.slice(22),r=n.lastIndexOf(`:`);if(r===-1)return null;let i=n.slice(0,r),a=n.slice(r+1);return!i||!a||a.includes(`:`)?null:{configId:i,key:a}}function i(e,t){if(!e.startsWith(t))return!1;let n=e.slice(t.length),r=n.indexOf(`:`);return!(r<=0||r>=n.length-1)}function a(e){if(!e.startsWith(n))return null;try{let t=JSON.parse(e.slice(16));return!Array.isArray(t)||t.length!==2||typeof t[0]!=`string`||typeof t[1]!=`string`||t[0].length===0||t[1].length===0?null:{clientId:t[0],accountId:t[1]}}catch{return null}}function o(e){if(r(e))return!0;if(e.startsWith(`env:`)){let t=e.slice(4);return/^[A-Za-z_][A-Za-z0-9_]*$/.test(t)}return e.startsWith(`file:`)?e.length>5:!!(i(e,`keychain:`)||a(e))}function s(e){return a(e)!==null}const c=e.string().refine(o,{message:`Invalid credential reference format.`}).brand();function l(e,n){if(n.includes(`:`))throw Error(`Credential key must not contain colons: "${n}"`);return c.parse(`${t}${e}:${n}`)}function u(e,t){return c.parse(`${n}${JSON.stringify([e,t])}`)}function d(e){return r(e)}function f(e){if(!e)return;let t={};for(let[n,r]of Object.entries(e))t[n]=c.parse(r);return t}function p(e){if(e)return Object.fromEntries(Object.entries(e).map(([e,t])=>[e,t]))}export{s as a,l as i,f as n,d as o,u as r,p as s,c as t};

package/dist/cursor-storage-CtVJ3JzB.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createStorageNamespaceDefinition as t}from"@makaio/framework/storage";const n=new WeakMap,r=new WeakMap,i=new WeakMap,a=Symbol(`anyProducer`),o=Promise.resolve(),s=Symbol(`listenerAdded`),c=Symbol(`listenerRemoved`);let l=!1,u=!1;const d=e=>typeof e==`string`||typeof e==`symbol`||typeof e==`number`;function f(e){if(!d(e))throw TypeError("`eventName` must be a string, symbol, or number")}function p(e){if(typeof e!=`function`)throw TypeError(`listener must be a function`)}function m(e,t){let n=r.get(e);if(n.has(t))return n.get(t)}function h(e,t){let n=d(t)?t:a,r=i.get(e);if(r.has(n))return r.get(n)}function g(e,t,n){let r=i.get(e);if(r.has(t))for(let e of r.get(t))e.enqueue(n);if(r.has(a)){let e=Promise.all([t,n]);for(let t of r.get(a))t.enqueue(e)}}function _(e,t){t=Array.isArray(t)?t:[t];let n=!1,r=()=>{},a=[],o={enqueue(e){a.push(e),r()},finish(){n=!0,r()}};for(let n of t){let t=h(e,n);t||(t=new Set,i.get(e).set(n,t)),t.add(o)}return{async next(){return a?a.length===0?n?(a=void 0,this.next()):(await new Promise(e=>{r=e}),this.next()):{done:!1,value:await a.shift()}:{done:!0}},async return(n){a=void 0;for(let n of t){let t=h(e,n);t&&(t.delete(o),t.size===0&&i.get(e).delete(n))}return r(),arguments.length>0?{done:!0,value:await n}:{done:!0}},[Symbol.asyncIterator](){return this}}}function v(e){if(e===void 0)return S;if(!Array.isArray(e))throw TypeError("`methodNames` must be an array of strings");for(let t of e)if(!S.includes(t))throw typeof t==`string`?Error(`${t} is not Emittery method`):TypeError("`methodNames` element must be a string");return e}const y=e=>e===s||e===c;function b(e,t,n){if(y(t))try{l=!0,e.emit(t,n)}finally{l=!1}}var x=class e{static mixin(t,n){return n=v(n),r=>{if(typeof r!=`function`)throw TypeError("`target` must be function");for(let e of n)if(r.prototype[e]!==void 0)throw Error(`The property \`${e}\` already exists on \`target\``);function i(){return Object.defineProperty(this,t,{enumerable:!1,value:new e}),this[t]}Object.defineProperty(r.prototype,t,{enumerable:!1,get:i});let a=e=>function(...n){return this[t][e](...n)};for(let e of n)Object.defineProperty(r.prototype,e,{enumerable:!1,value:a(e)});return r}}static get isDebugEnabled(){if(typeof globalThis.process?.env!=`object`)return u;let{env:e}=globalThis.process??{env:{}};return e.DEBUG===`emittery`||e.DEBUG===`*`||u}static set isDebugEnabled(e){u=e}constructor(e={}){n.set(this,new Set),r.set(this,new Map),i.set(this,new Map),i.get(this).set(a,new Set),this.debug=e.debug??{},this.debug.enabled===void 0&&(this.debug.enabled=!1),this.debug.logger||(this.debug.logger=(e,t,n,r)=>{try{r=JSON.stringify(r)}catch{r=`Object with the following keys failed to stringify: ${Object.keys(r).join(`,`)}`}(typeof n==`symbol`||typeof n==`number`)&&(n=n.toString());let i=new Date,a=`${i.getHours()}:${i.getMinutes()}:${i.getSeconds()}.${i.getMilliseconds()}`;console.log(`[${a}][emittery:${e}][${t}] Event Name: ${n}\n\tdata: ${r}`)})}logIfDebugEnabled(t,n,r){(e.isDebugEnabled||this.debug.enabled)&&this.debug.logger(t,this.debug.name,n,r)}on(e,t,{signal:n}={}){p(t),e=Array.isArray(e)?e:[e];for(let n of e){f(n);let e=m(this,n);e||(e=new Set,r.get(this).set(n,e)),e.add(t),this.logIfDebugEnabled(`subscribe`,n,void 0),y(n)||b(this,s,{eventName:n,listener:t})}let i=()=>{this.off(e,t),n?.removeEventListener(`abort`,i)};return n?.addEventListener(`abort`,i,{once:!0}),n?.aborted&&i(),i}off(e,t){p(t),e=Array.isArray(e)?e:[e];for(let n of e){f(n);let e=m(this,n);e&&(e.delete(t),e.size===0&&r.get(this).delete(n)),this.logIfDebugEnabled(`unsubscribe`,n,void 0),y(n)||b(this,c,{eventName:n,listener:t})}}once(e,t){if(t!==void 0&&typeof t!=`function`)throw TypeError(`predicate must be a function`);let n,r=new Promise(r=>{n=this.on(e,e=>{t&&!t(e)||(n(),r(e))})});return r.off=n,r}events(e){e=Array.isArray(e)?e:[e];for(let t of e)f(t);return _(this,e)}async emit(e,t){if(f(e),y(e)&&!l)throw TypeError("`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`");this.logIfDebugEnabled(`emit`,e,t),g(this,e,t);let r=m(this,e)??new Set,i=n.get(this),a=[...r],s=y(e)?[]:[...i];await o,await Promise.all([...a.map(async e=>{if(r.has(e))return e(t)}),...s.map(async n=>{if(i.has(n))return n(e,t)})])}async emitSerial(e,t){if(f(e),y(e)&&!l)throw TypeError("`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`");this.logIfDebugEnabled(`emitSerial`,e,t),g(this,e,t);let r=m(this,e)??new Set,i=n.get(this),a=[...r],s=y(e)?[]:[...i];await o;for(let e of a)r.has(e)&&await e(t);for(let n of s)i.has(n)&&await n(e,t)}onAny(e,{signal:t}={}){p(e),this.logIfDebugEnabled(`subscribeAny`,void 0,void 0),n.get(this).add(e),b(this,s,{listener:e});let r=()=>{this.offAny(e),t?.removeEventListener(`abort`,r)};return t?.addEventListener(`abort`,r,{once:!0}),t?.aborted&&r(),r}anyEvent(){return _(this)}offAny(e){p(e),this.logIfDebugEnabled(`unsubscribeAny`,void 0,void 0),b(this,c,{listener:e}),n.get(this).delete(e)}clearListeners(e){e=Array.isArray(e)?e:[e];for(let t of e)if(this.logIfDebugEnabled(`clear`,t,void 0),d(t)){let e=m(this,t);e&&e.clear();let n=h(this,t);if(n){for(let e of n)e.finish();n.clear()}}else{n.get(this).clear();for(let[e,t]of r.get(this).entries())t.clear(),r.get(this).delete(e);for(let[e,t]of i.get(this).entries()){for(let e of t)e.finish();t.clear(),i.get(this).delete(e)}}}listenerCount(e){e=Array.isArray(e)?e:[e];let t=0;for(let a of e){if(d(a)){t+=n.get(this).size+(m(this,a)?.size??0)+(h(this,a)?.size??0)+(h(this)?.size??0);continue}a!==void 0&&f(a),t+=n.get(this).size;for(let e of r.get(this).values())t+=e.size;for(let e of i.get(this).values())t+=e.size}return t}bindMethods(e,t){if(typeof e!=`object`||!e)throw TypeError("`target` must be an object");t=v(t);for(let n of t){if(e[n]!==void 0)throw Error(`The property \`${n}\` already exists on \`target\``);Object.defineProperty(e,n,{enumerable:!1,value:this[n].bind(this)})}}};const S=Object.getOwnPropertyNames(x.prototype).filter(e=>e!==`constructor`);Object.defineProperty(x,`listenerAdded`,{value:s,writable:!1,enumerable:!0,configurable:!1}),Object.defineProperty(x,`listenerRemoved`,{value:c,writable:!1,enumerable:!0,configurable:!1});const C=e.custom(()=>!0),w=e.object({filePath:e.string(),bytesRead:e.number(),lastModified:e.string(),sessionContext:C.optional()}),T=t(`importCursor`,{schemas:{get:{request:e.object({filePath:e.string()}),response:e.object({cursor:w.nullable()})},set:{request:w,response:e.object({success:e.boolean()})},delete:{request:e.object({filePath:e.string()}),response:e.object({success:e.boolean()})}}}),E=T.subjects;export{x as i,T as n,E as r,w as t};