@orgloop/sdk 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrgLoop contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/connector.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Connector interfaces — the contract between OrgLoop and external systems.
+ *
+ * Connectors bridge the gap between OrgLoop's event model and specific platforms.
+ * A connector can provide a source (inbound events), a target (outbound delivery), or both.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ActorConfig, OrgLoopEvent, RouteDeliveryConfig, SourceConfig } from './types.js';
+/** Result of a poll operation */
+export interface PollResult {
+    /** Events discovered since the last checkpoint */
+    events: OrgLoopEvent[];
+    /** Opaque checkpoint string for crash recovery */
+    checkpoint: string;
+}
+/** HTTP request handler for webhook-based sources */
+export type WebhookHandler = (req: IncomingMessage, res: ServerResponse) => Promise<OrgLoopEvent[]>;
+/**
+ * Source connector interface.
+ *
+ * Implement this to create a new event source for OrgLoop.
+ * Sources can be poll-based (the runtime calls poll() on a schedule)
+ * or webhook-based (the runtime mounts a webhook handler).
+ */
+export interface SourceConnector {
+    /** Unique connector ID */
+    readonly id: string;
+    /** Initialize with user-provided config */
+    init(config: SourceConfig): Promise<void>;
+    /**
+     * Poll for new events since the last checkpoint.
+     * The runtime calls this on the configured interval.
+     * Return an array of normalized OrgLoop events.
+     */
+    poll(checkpoint: string | null): Promise<PollResult>;
+    /**
+     * Optional: Register a webhook handler.
+     * Return a request handler the server will mount.
+     * For push-based sources.
+     */
+    webhook?(): WebhookHandler;
+    /** Clean shutdown */
+    shutdown(): Promise<void>;
+}
+/** Result of a delivery operation */
+export interface DeliveryResult {
+    /** Delivery status */
+    status: 'delivered' | 'rejected' | 'error';
+    /** If the actor produces a response event, return it */
+    responseEvent?: OrgLoopEvent;
+    /** Error details if status is 'error' */
+    error?: Error;
+}
+/**
+ * Actor (target) connector interface.
+ *
+ * Implement this to create a new delivery target for OrgLoop.
+ * Actors receive events when routes match.
+ */
+export interface ActorConnector {
+    /** Unique connector ID */
+    readonly id: string;
+    /** Initialize with user-provided config */
+    init(config: ActorConfig): Promise<void>;
+    /**
+     * Deliver an event to this actor.
+     * routeConfig includes actor-specific config from then.config
+     * plus the resolved launch prompt (if the route has with).
+     */
+    deliver(event: OrgLoopEvent, routeConfig: RouteDeliveryConfig): Promise<DeliveryResult>;
+    /** Clean shutdown */
+    shutdown(): Promise<void>;
+}
+/**
+ * Validates that a credential value actually works against the external service.
+ *
+ * Stage 2 connector maturity — goes beyond checking if an env var is set
+ * to verifying it authenticates successfully and reporting identity/scopes.
+ */
+export interface CredentialValidator {
+    validate(value: string): Promise<{
+        valid: boolean;
+        /** Identity associated with the credential (e.g., "user: @alice") */
+        identity?: string;
+        /** Permission scopes granted (e.g., ["repo", "read:org"]) */
+        scopes?: string[];
+        /** Error message if validation failed */
+        error?: string;
+    }>;
+}
+/**
+ * Detects whether an external service is running and reachable.
+ *
+ * Stage 2 connector maturity — used by `orgloop doctor` to report service
+ * availability. External tools (e.g., orgctl) can also consume this interface.
+ */
+export interface ServiceDetector {
+    detect(): Promise<{
+        running: boolean;
+        version?: string;
+        endpoint?: string;
+        details?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Connector registration — what a connector package exports.
+ *
+ * A connector package's default export is a function that returns this object.
+ * The runtime calls it once at startup to discover the connector's capabilities.
+ */
+export interface ConnectorRegistration {
+    /** Unique connector ID */
+    id: string;
+    /** Source connector class (if this connector can be a source) */
+    source?: new () => SourceConnector;
+    /** Target/actor connector class (if this connector can be a target) */
+    target?: new () => ActorConnector;
+    /** JSON Schema for config validation */
+    configSchema?: Record<string, unknown>;
+    /** Setup metadata for onboarding — env vars, integration steps, etc. */
+    setup?: ConnectorSetup;
+    /** Service detector for checking if external services are running */
+    service_detector?: ServiceDetector;
+    /** Credential validators keyed by env var name (e.g., "GITHUB_TOKEN") */
+    credential_validators?: Record<string, CredentialValidator>;
+}
+/**
+ * Rich definition for an environment variable required by a connector.
+ *
+ * Provides metadata that the CLI uses to guide users through setup —
+ * descriptions, help URLs, and commands to create/acquire credentials.
+ */
+export interface EnvVarDefinition {
+    /** Environment variable name */
+    name: string;
+    /** Human-readable description of what this var is for */
+    description: string;
+    /** URL where the user can get/create this credential */
+    help_url?: string;
+    /** Command to run that helps set up this variable */
+    help_command?: string;
+    /** Whether this var is required (default: true) */
+    required?: boolean;
+}
+/**
+ * Connector setup metadata.
+ *
+ * Declarative onboarding information that the CLI can use to guide users
+ * through connector installation. This is pure metadata — the CLI decides
+ * how to act on it.
+ */
+export interface ConnectorSetup {
+    /** Environment variables required by this connector (string or rich definition) */
+    env_vars?: (string | EnvVarDefinition)[];
+    /**
+     * External integration steps required for this connector to function.
+     * Each entry describes one integration the user needs to configure
+     * outside of OrgLoop (e.g., registering a webhook, installing a hook
+     * in another tool, creating an API token).
+     */
+    integrations?: ConnectorIntegration[];
+}
+/** An external integration step required by a connector. */
+export interface ConnectorIntegration {
+    /** Short identifier (e.g., "claude-code-hook", "github-webhook") */
+    id: string;
+    /** Human-readable description of what needs to be configured */
+    description: string;
+    /** The tool/platform this integration targets (e.g., "claude-code", "github", "slack") */
+    platform: string;
+    /** Optional: a command that can automate the setup */
+    command?: string;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

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

package/dist/connector.js

@@ -0,0 +1,8 @@
+/**
+ * Connector interfaces — the contract between OrgLoop and external systems.
+ *
+ * Connectors bridge the gap between OrgLoop's event model and specific platforms.
+ * A connector can provide a source (inbound events), a target (outbound delivery), or both.
+ */
+export {};
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/event.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Event builder and validators — helpers for creating and validating OrgLoop events.
+ */
+import type { EventProvenance, OrgLoopEvent, OrgLoopEventType } from './types.js';
+/**
+ * Generate a unique event ID with the evt_ prefix.
+ * Uses UUID v4 for uniqueness.
+ */
+export declare function generateEventId(): string;
+/**
+ * Generate a trace ID with the trc_ prefix.
+ */
+export declare function generateTraceId(): string;
+/** Options for building an event */
+export interface BuildEventOptions {
+    source: string;
+    type: OrgLoopEventType;
+    provenance: EventProvenance;
+    payload?: Record<string, unknown>;
+    id?: string;
+    timestamp?: string;
+    trace_id?: string;
+}
+/**
+ * Build a well-formed OrgLoop event.
+ * Fills in defaults for id, timestamp, and trace_id.
+ */
+export declare function buildEvent(options: BuildEventOptions): OrgLoopEvent;
+/** Validation error */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate an OrgLoop event.
+ * Returns an array of validation errors (empty if valid).
+ */
+export declare function validateEvent(event: unknown): ValidationError[];
+/**
+ * Check if a value is a valid OrgLoop event (type guard).
+ */
+export declare function isOrgLoopEvent(value: unknown): value is OrgLoopEvent;
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AASlF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAUnE;AAED,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAyC/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/event.js

@@ -0,0 +1,87 @@
+/**
+ * Event builder and validators — helpers for creating and validating OrgLoop events.
+ */
+import { randomUUID } from 'node:crypto';
+/** Valid OaC event types */
+const VALID_EVENT_TYPES = new Set([
+    'resource.changed',
+    'actor.stopped',
+    'message.received',
+]);
+/**
+ * Generate a unique event ID with the evt_ prefix.
+ * Uses UUID v4 for uniqueness.
+ */
+export function generateEventId() {
+    return `evt_${randomUUID().replace(/-/g, '').substring(0, 16)}`;
+}
+/**
+ * Generate a trace ID with the trc_ prefix.
+ */
+export function generateTraceId() {
+    return `trc_${randomUUID().replace(/-/g, '').substring(0, 16)}`;
+}
+/**
+ * Build a well-formed OrgLoop event.
+ * Fills in defaults for id, timestamp, and trace_id.
+ */
+export function buildEvent(options) {
+    return {
+        id: options.id ?? generateEventId(),
+        timestamp: options.timestamp ?? new Date().toISOString(),
+        source: options.source,
+        type: options.type,
+        provenance: options.provenance,
+        payload: options.payload ?? {},
+        trace_id: options.trace_id ?? generateTraceId(),
+    };
+}
+/**
+ * Validate an OrgLoop event.
+ * Returns an array of validation errors (empty if valid).
+ */
+export function validateEvent(event) {
+    const errors = [];
+    if (!event || typeof event !== 'object') {
+        errors.push({ field: '', message: 'Event must be a non-null object' });
+        return errors;
+    }
+    const e = event;
+    // Required fields
+    if (typeof e.id !== 'string' || !e.id.startsWith('evt_')) {
+        errors.push({ field: 'id', message: 'id must be a string starting with "evt_"' });
+    }
+    if (typeof e.timestamp !== 'string') {
+        errors.push({ field: 'timestamp', message: 'timestamp must be an ISO 8601 string' });
+    }
+    if (typeof e.source !== 'string' || e.source.length === 0) {
+        errors.push({ field: 'source', message: 'source must be a non-empty string' });
+    }
+    if (typeof e.type !== 'string' || !VALID_EVENT_TYPES.has(e.type)) {
+        errors.push({
+            field: 'type',
+            message: `type must be one of: ${[...VALID_EVENT_TYPES].join(', ')}`,
+        });
+    }
+    // Provenance
+    if (!e.provenance || typeof e.provenance !== 'object') {
+        errors.push({ field: 'provenance', message: 'provenance must be an object' });
+    }
+    else {
+        const prov = e.provenance;
+        if (typeof prov.platform !== 'string') {
+            errors.push({
+                field: 'provenance.platform',
+                message: 'provenance.platform must be a string',
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Check if a value is a valid OrgLoop event (type guard).
+ */
+export function isOrgLoopEvent(value) {
+    return validateEvent(value).length === 0;
+}
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @orgloop/sdk — OrgLoop Plugin Development Kit
+ *
+ * This package provides the interfaces, helpers, and test harnesses
+ * for building OrgLoop plugins (connectors, transforms, loggers).
+ */
+export type { OrgLoopEvent, OrgLoopEventType, AuthorType, EventProvenance, SourceConfig, ActorConfig, PollConfig, RouteDefinition, RouteWhen, RouteTransformRef, RouteThen, RouteWith, RouteDeliveryConfig, TransformDefinition, LoggerDefinition, DeliveryConfig, RetryConfig, CircuitBreakerConfig, LogPhase, LogEntry, ProjectConfig, OrgLoopConfig, SourceInstanceConfig, ActorInstanceConfig, EventFilter, EventHandler, Subscription, DurationString, } from './types.js';
+export { parseDuration } from './types.js';
+export type { SourceConnector, ActorConnector, PollResult, DeliveryResult, WebhookHandler, ConnectorRegistration, ConnectorSetup, ConnectorIntegration, EnvVarDefinition, CredentialValidator, ServiceDetector, } from './connector.js';
+export type { Transform, TransformContext, TransformRegistration, } from './transform.js';
+export type { Logger, LoggerRegistration, } from './logger.js';
+export { generateEventId, generateTraceId, buildEvent, validateEvent, isOrgLoopEvent, } from './event.js';
+export type { BuildEventOptions, ValidationError } from './event.js';
+export type { ModuleManifest, ModuleMetadata, ModuleRequirements, ModuleConnectorRequirement, ModuleServiceRequirement, ModuleCredentialRequirement, ModuleHookRequirement, ModuleParameter, ModuleProvides, InstalledModule, ModuleExpansionContext, } from './module.js';
+export { expandTemplate, expandTemplateDeep, moduleManifestSchema } from './module.js';
+export { MockSource, MockActor, MockTransform, MockLogger, createTestEvent, createTestContext, } from './testing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,YAAY,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GACf,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACX,MAAM,EACN,kBAAkB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGrE,YAAY,EACX,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGvF,OAAO,EACN,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,iBAAiB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @orgloop/sdk — OrgLoop Plugin Development Kit
+ *
+ * This package provides the interfaces, helpers, and test harnesses
+ * for building OrgLoop plugins (connectors, transforms, loggers).
+ */
+export { parseDuration } from './types.js';
+// Event helpers
+export { generateEventId, generateTraceId, buildEvent, validateEvent, isOrgLoopEvent, } from './event.js';
+export { expandTemplate, expandTemplateDeep, moduleManifestSchema } from './module.js';
+// Test harness
+export { MockSource, MockActor, MockTransform, MockLogger, createTestEvent, createTestContext, } from './testing.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkCH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA8B3C,gBAAgB;AAChB,OAAO,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,GACd,MAAM,YAAY,CAAC;AAkBpB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEvF,eAAe;AACf,OAAO,EACN,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,iBAAiB,GACjB,MAAM,cAAc,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Logger interface — passive observers of the event pipeline.
+ *
+ * Loggers receive LogEntry records for every pipeline phase:
+ * source emit, transform results, route matches, delivery attempts.
+ */
+import type { LogEntry } from './types.js';
+/**
+ * Logger interface.
+ *
+ * Implement this to create a new log destination for OrgLoop.
+ * Loggers are called for every pipeline event — they should be fast.
+ */
+export interface Logger {
+    /** Unique logger ID */
+    readonly id: string;
+    /** Initialize with config */
+    init(config: Record<string, unknown>): Promise<void>;
+    /**
+     * Called for every pipeline event.
+     * Should not throw — log errors should be handled internally.
+     */
+    log(entry: LogEntry): Promise<void>;
+    /** Flush any buffered entries */
+    flush(): Promise<void>;
+    /** Clean shutdown (flush + close) */
+    shutdown(): Promise<void>;
+}
+/**
+ * Logger registration — what a logger package exports.
+ */
+export interface LoggerRegistration {
+    /** Unique logger ID */
+    id: string;
+    /** Logger class */
+    logger: new () => Logger;
+    /** JSON Schema for config validation */
+    configSchema?: Record<string, unknown>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,qCAAqC;IACrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,MAAM,EAAE,UAAU,MAAM,CAAC;IACzB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC"}

package/dist/logger.js

@@ -0,0 +1,8 @@
+/**
+ * Logger interface — passive observers of the event pipeline.
+ *
+ * Loggers receive LogEntry records for every pipeline phase:
+ * source emit, transform results, route matches, delivery attempts.
+ */
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}