@agentworkforce/events 0.1.0 → 4.1.20

package/dist/registry.js

@@ -0,0 +1,180 @@
+import { redactEventValue } from './redact.js';
+import { validateJsonSchema, withoutSchemaIdentifiers } from './json-schema.js';
+import { EVENT_FRAME_V1_SCHEMA, EVENT_SUMMARY_SCHEMA } from './schemas.js';
+import { validateEventFrameV1 } from './validate.js';
+const OPEN_PAYLOAD_SCHEMA = Object.freeze({});
+function example(id, provider, trigger, resourceKind, overrides = {}) {
+    return {
+        schemaVersion: 1,
+        id: `evt_${id.replaceAll('.', '_')}`,
+        workspace: 'ws_example',
+        type: id,
+        contractVersion: 1,
+        occurredAt: '2026-07-15T09:00:00.000Z',
+        attempt: 1,
+        resource: {
+            path: `/${provider}/${resourceKind.slice(provider.length + 1).replaceAll('.', 's/')}/example`,
+            kind: resourceKind,
+            id: 'example',
+            provider
+        },
+        summary: { title: `${id} example` },
+        payload: { action: trigger.split('.').at(-1) },
+        ...overrides
+    };
+}
+function contract(config) {
+    return Object.freeze({
+        id: config.id,
+        version: 1,
+        provider: config.provider,
+        trigger: config.trigger,
+        resourceKind: config.resourceKind,
+        summarySchema: EVENT_SUMMARY_SCHEMA,
+        payloadSchema: config.payloadSchema ?? OPEN_PAYLOAD_SCHEMA,
+        fixtureExamples: Object.freeze([config.fixture]),
+        redact: (payload) => redactEventValue(payload),
+        validate(frame) {
+            const base = validateEventFrameV1(frame);
+            if (!base.valid)
+                return base;
+            const errors = [];
+            if (frame.type !== config.id)
+                errors.push({ path: '$.type', message: `must equal ${config.id}`, keyword: 'const' });
+            if (frame.contractVersion !== 1)
+                errors.push({ path: '$.contractVersion', message: 'must equal 1', keyword: 'const' });
+            if (frame.resource.provider !== config.provider)
+                errors.push({ path: '$.resource.provider', message: `must equal ${config.provider}`, keyword: 'const' });
+            if (frame.resource.kind !== config.resourceKind)
+                errors.push({ path: '$.resource.kind', message: `must equal ${config.resourceKind}`, keyword: 'const' });
+            const summary = validateJsonSchema(EVENT_SUMMARY_SCHEMA, frame.summary, '$.summary');
+            if (!summary.valid)
+                errors.push(...summary.errors);
+            if (frame.payload !== undefined) {
+                const payload = validateJsonSchema(config.payloadSchema ?? OPEN_PAYLOAD_SCHEMA, frame.payload, '$.payload');
+                if (!payload.valid)
+                    errors.push(...payload.errors);
+            }
+            return errors.length === 0 ? { valid: true, errors: [] } : { valid: false, errors };
+        }
+    });
+}
+export const EVENT_CONTRACTS = Object.freeze([
+    contract({
+        id: 'startup',
+        provider: 'runtime',
+        trigger: 'startup',
+        resourceKind: 'runtime.startup',
+        fixture: example('startup', 'runtime', 'startup', 'runtime.startup', {
+            resource: { path: '/runtime/startups/evt_startup', kind: 'runtime.startup', id: 'evt_startup', provider: 'runtime' },
+            summary: { title: 'Agent runtime started' },
+            payload: undefined
+        })
+    }),
+    contract({
+        id: 'cron.tick',
+        provider: 'cron',
+        trigger: 'tick',
+        resourceKind: 'cron.schedule',
+        fixture: example('cron.tick', 'cron', 'tick', 'cron.schedule', {
+            resource: { path: '/cron/schedules/scan', kind: 'cron.schedule', id: 'scan', provider: 'cron' },
+            summary: { title: 'Scheduled scan' },
+            schedule: { name: 'scan', cron: '0 9 * * *', timezone: 'UTC', scheduledFor: '2026-07-15T09:00:00.000Z' },
+            payload: undefined
+        })
+    }),
+    contract({
+        id: 'github.issues.labeled',
+        provider: 'github',
+        trigger: 'issues.labeled',
+        resourceKind: 'github.issue',
+        fixture: example('github.issues.labeled', 'github', 'issues.labeled', 'github.issue', {
+            resource: { path: '/github/repos/acme/app/issues/42.json', kind: 'github.issue', id: '42', provider: 'github' },
+            summary: { title: 'Issue #42 labeled bug', actor: 'octocat' },
+            payload: { action: 'labeled', issue: { number: 42 }, label: { name: 'bug' } }
+        })
+    }),
+    contract({
+        id: 'github.pull_request.opened',
+        provider: 'github',
+        trigger: 'pull_request.opened',
+        resourceKind: 'github.pull_request',
+        fixture: example('github.pull_request.opened', 'github', 'pull_request.opened', 'github.pull_request', {
+            resource: { path: '/github/repos/acme/app/pulls/7.json', kind: 'github.pull_request', id: '7', provider: 'github' },
+            summary: { title: 'PR #7 opened', actor: 'octocat' },
+            payload: { action: 'opened', pull_request: { number: 7 } }
+        })
+    }),
+    contract({
+        id: 'slack.message.created',
+        provider: 'slack',
+        trigger: 'message.created',
+        resourceKind: 'slack.message',
+        fixture: example('slack.message.created', 'slack', 'message.created', 'slack.message', {
+            resource: { path: '/slack/channels/C123/messages/171.json', kind: 'slack.message', id: '171', provider: 'slack' },
+            summary: { title: 'New Slack message', actor: 'U123' },
+            message: { channel: 'C123', messageId: '171' },
+            payload: { channel: 'C123', user: 'U123', text: 'hello' }
+        })
+    }),
+    contract({
+        id: 'linear.issue.created',
+        provider: 'linear',
+        trigger: 'issue.created',
+        resourceKind: 'linear.issue',
+        fixture: example('linear.issue.created', 'linear', 'issue.created', 'linear.issue', {
+            resource: { path: '/linear/issues/ENG-1.json', kind: 'linear.issue', id: 'ENG-1', provider: 'linear' },
+            summary: { title: 'ENG-1 created', actor: 'user@example.com' },
+            payload: { action: 'create', issue: { identifier: 'ENG-1', title: 'Ship it' } }
+        })
+    }),
+    contract({
+        id: 'relaycast.message',
+        provider: 'relaycast',
+        trigger: 'message',
+        resourceKind: 'relaycast.message',
+        fixture: example('relaycast.message', 'relaycast', 'message', 'relaycast.message', {
+            resource: { path: '/relaycast/general/messages/msg_1', kind: 'relaycast.message', id: 'msg_1', provider: 'relaycast' },
+            summary: { title: 'Can you take a look?' },
+            message: { channel: 'general', messageId: 'msg_1', threadId: 'thread_1' },
+            payload: { text: 'Can you take a look?' }
+        })
+    })
+]);
+const BY_KEY = new Map(EVENT_CONTRACTS.map((entry) => [`${entry.id}@${entry.version}`, entry]));
+export function getEventContract(id, version = 1) {
+    return BY_KEY.get(`${id}@${version}`);
+}
+export function requireEventContract(id, version = 1) {
+    const entry = getEventContract(id, version);
+    if (!entry)
+        throw new Error(`Unknown Event contract: ${id}@${version}`);
+    return entry;
+}
+export const EVENT_CONTRACT_JSON_SCHEMAS = Object.freeze(Object.fromEntries(EVENT_CONTRACTS.map((entry) => [
+    `${entry.id}@${entry.version}`,
+    {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: `https://agentworkforce.dev/schemas/events/${entry.id}/v${entry.version}.json`,
+        allOf: [
+            withoutSchemaIdentifiers(EVENT_FRAME_V1_SCHEMA),
+            {
+                type: 'object',
+                properties: {
+                    type: { const: entry.id },
+                    contractVersion: { const: entry.version },
+                    resource: {
+                        type: 'object',
+                        properties: {
+                            provider: { const: entry.provider },
+                            kind: { const: entry.resourceKind }
+                        }
+                    },
+                    summary: entry.summarySchema,
+                    ...(entry.payloadSchema ? { payload: entry.payloadSchema } : {})
+                }
+            }
+        ]
+    }
+])));
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../src/registry.test.ts"],"names":[],"mappings":""}

package/dist/registry.test.js

@@ -0,0 +1,113 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import addFormatsModule from 'ajv-formats';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import { decodeEventFrame, EVENT_CONTRACTS, EVENT_CONTRACT_JSON_SCHEMAS, parseEventFrame, redactEventValue, safeParseEventFrame } from './index.js';
+test('every registry entry exports schema and validating example fixtures', () => {
+    assert.deepEqual(EVENT_CONTRACTS.map((entry) => entry.id), [
+        'startup',
+        'cron.tick',
+        'github.issues.labeled',
+        'github.pull_request.opened',
+        'slack.message.created',
+        'linear.issue.created',
+        'relaycast.message'
+    ]);
+    for (const contract of EVENT_CONTRACTS) {
+        assert.ok(EVENT_CONTRACT_JSON_SCHEMAS[`${contract.id}@${contract.version}`]);
+        assert.ok(contract.fixtureExamples.length > 0);
+        for (const fixture of contract.fixtureExamples) {
+            assert.equal(parseEventFrame(fixture), fixture);
+            assert.deepEqual(contract.validate(fixture), { valid: true, errors: [] });
+        }
+    }
+});
+test('all exported contract schemas register together without identifier collisions', () => {
+    const ajv = new Ajv2020({ strict: true });
+    addFormatsModule(ajv);
+    for (const schema of Object.values(EVENT_CONTRACT_JSON_SCHEMAS))
+        ajv.addSchema(schema);
+});
+test('known schema versions reject unknown top-level fields and preserve extensions', () => {
+    const fixture = EVENT_CONTRACTS[1].fixtureExamples[0];
+    assert.equal(safeParseEventFrame({ ...fixture, surprise: true }).success, false);
+    const extended = { ...fixture, extensions: { futureCapability: { enabled: true } } };
+    assert.deepEqual(parseEventFrame(extended).extensions, { futureCapability: { enabled: true } });
+});
+test('legacy gateway envelopes decode with visible compatibility metadata', () => {
+    const decoded = decodeEventFrame({
+        id: 'evt_legacy',
+        workspace: 'ws_1',
+        type: 'github.issue.labeled',
+        occurredAt: '2026-07-15T09:00:00.000Z',
+        attempt: 2,
+        provider: 'github',
+        deliveryId: 'delivery_1',
+        paths: ['/github/repos/acme/app/issues/42.json'],
+        resource: { action: 'labeled', issue: { number: 42 } },
+        summary: { title: 'Issue labeled' },
+        resumeContext: { phase: 2 },
+        vendorFutureField: { retained: true }
+    });
+    assert.equal(decoded.frame.type, 'github.issues.labeled');
+    assert.equal(decoded.frame.contractVersion, 1);
+    assert.deepEqual(decoded.frame.payload, { action: 'labeled', issue: { number: 42 } });
+    assert.equal(decoded.compatibility?.source, 'legacy-raw-gateway-envelope');
+    assert.deepEqual(decoded.compatibility?.aliasesApplied, ['github.issue.labeled -> github.issues.labeled']);
+    assert.deepEqual(decoded.frame.extensions?.vendorFutureField, { retained: true });
+    assert.deepEqual(decoded.frame.extensions?.resumeContext, { phase: 2 });
+});
+test('legacy cron and relaycast envelopes retain their specialized coordinates', () => {
+    const cron = decodeEventFrame({ id: 'cron_1', workspace: 'ws', type: 'cron.tick', occurredAt: '2026-07-15T09:00:00Z', name: 'scan', cron: '0 9 * * *' });
+    assert.deepEqual(cron.frame.schedule, { name: 'scan', cron: '0 9 * * *' });
+    assert.equal(cron.frame.resource.id, 'scan');
+    const relay = decodeEventFrame({ id: 'msg_evt', workspace: 'ws', type: 'relaycast.message', occurredAt: '2026-07-15T09:00:00Z', channel: 'general', messageId: 'm1', threadId: 't1', resource: { text: 'hello' } });
+    assert.deepEqual(relay.frame.message, { channel: 'general', messageId: 'm1', threadId: 't1' });
+    assert.equal(relay.frame.resource.kind, 'relaycast.message');
+});
+test('legacy startup remains compatible and resource lookalikes retain provider data', () => {
+    const startup = decodeEventFrame({ id: 'evt_boot', workspace: 'ws', type: 'startup', occurredAt: '2026-07-15T09:00:00Z' });
+    assert.equal(startup.frame.type, 'startup');
+    assert.equal(startup.frame.resource.kind, 'runtime.startup');
+    const github = decodeEventFrame({
+        id: 'evt_resource',
+        workspace: 'ws',
+        type: 'github.issues.labeled',
+        occurredAt: '2026-07-15T09:00:00Z',
+        resource: { path: '/provider/path', kind: 'github.issue', id: '42', provider: 'github', action: 'labeled' }
+    });
+    assert.deepEqual(github.frame.payload, { path: '/provider/path', kind: 'github.issue', id: '42', provider: 'github', action: 'labeled' });
+    assert.equal(github.frame.resource.path.includes('//'), false);
+});
+test('legacy extension copying is prototype-safe and preserves compatibility collisions', () => {
+    const legacy = JSON.parse('{"id":"evt_proto","workspace":"ws","type":"startup","occurredAt":"2026-07-15T09:00:00Z","__proto__":{"polluted":true},"compatibility":{"vendor":"original"}}');
+    const decoded = decodeEventFrame(legacy);
+    assert.equal(Object.prototype.hasOwnProperty.call(decoded.frame.extensions, '__proto__'), true);
+    assert.deepEqual(decoded.frame.extensions?.__proto__, { polluted: true });
+    assert.deepEqual(decoded.compatibility?.originalCompatibility, { vendor: 'original' });
+    assert.equal({}.polluted, undefined);
+});
+test('schema-driven validation rejects malformed timestamps and summary fields', () => {
+    const fixture = EVENT_CONTRACTS[0].fixtureExamples[0];
+    assert.equal(safeParseEventFrame({ ...fixture, occurredAt: 'July 15, 2026' }).success, false);
+    assert.equal(safeParseEventFrame({ ...fixture, summary: { title: 42 } }).success, false);
+    assert.equal(safeParseEventFrame({ ...fixture, schedule: { name: 'scan', scheduledFor: '2026-02-30T00:00:00Z' } }).success, false);
+});
+test('redaction is recursive, immutable, and handles bearer strings', () => {
+    const input = { token: 'secret', nested: [{ authorization: 'Bearer abc.def', text: 'Bearer abc.def' }] };
+    const output = redactEventValue(input);
+    assert.deepEqual(output, { token: '[REDACTED]', nested: [{ authorization: '[REDACTED]', text: '[REDACTED]' }] });
+    assert.equal(input.token, 'secret');
+});
+test('redaction preserves prototype-looking data safely and treats global matchers statelessly', () => {
+    const input = JSON.parse('{"__proto__":{"safe":true},"first":"one","second":"two"}');
+    const output = redactEventValue(input, { additionalSensitiveKeys: [/first|second/g] });
+    assert.equal(Object.prototype.hasOwnProperty.call(output, '__proto__'), true);
+    assert.deepEqual(output.__proto__, { safe: true });
+    assert.equal(output.first, '[REDACTED]');
+    assert.equal(output.second, '[REDACTED]');
+    assert.equal({}.safe, undefined);
+    const date = new Date('2026-07-15T09:00:00Z');
+    assert.equal(redactEventValue(date), date);
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/registry.test.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,157 @@
+export declare const EVENT_SUMMARY_SCHEMA: {
+    readonly $id: "https://agentworkforce.dev/schemas/events/event-summary.json";
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+        };
+        readonly description: {
+            readonly type: "string";
+        };
+        readonly actor: {
+            readonly type: "string";
+        };
+    };
+    readonly additionalProperties: true;
+};
+/** Canonical JSON Schema export used by Cloud, fixtures, and replay tooling. */
+export declare const EVENT_FRAME_V1_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://agentworkforce.dev/schemas/events/event-frame-v1.json";
+    readonly title: "EventFrameV1";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["schemaVersion", "id", "workspace", "type", "contractVersion", "occurredAt", "attempt", "resource", "summary"];
+    readonly properties: {
+        readonly schemaVersion: {
+            readonly const: 1;
+        };
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly workspace: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly contractVersion: {
+            readonly type: "integer";
+            readonly minimum: 1;
+        };
+        readonly occurredAt: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly attempt: {
+            readonly type: "integer";
+            readonly minimum: 1;
+        };
+        readonly resource: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["path", "kind", "id", "provider"];
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly provider: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+            };
+        };
+        readonly summary: {
+            readonly $id: "https://agentworkforce.dev/schemas/events/event-summary.json";
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+                readonly actor: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: true;
+        };
+        readonly delivery: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly dedupeKey: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly payload: {};
+        readonly paths: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly digest: {
+            readonly type: "string";
+        };
+        readonly schedule: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["name"];
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly cron: {
+                    readonly type: "string";
+                };
+                readonly timezone: {
+                    readonly type: "string";
+                };
+                readonly scheduledFor: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+            };
+        };
+        readonly message: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly channel: {
+                    readonly type: "string";
+                };
+                readonly messageId: {
+                    readonly type: "string";
+                };
+                readonly threadId: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly extensions: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+    };
+};
+/** Derived from the schema so parsers and exported schema cannot drift. */
+export declare const EVENT_FRAME_V1_FIELDS: readonly (keyof typeof EVENT_FRAME_V1_SCHEMA.properties)[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;CASF,CAAC;AAEhC,gFAAgF;AAChF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEH,CAAC;AAEhC,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,EAE7B,SAAS,CAAC,MAAM,OAAO,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,84 @@
+const stringSchema = { type: 'string' };
+const nonEmptyStringSchema = { type: 'string', minLength: 1 };
+export const EVENT_SUMMARY_SCHEMA = {
+    $id: 'https://agentworkforce.dev/schemas/events/event-summary.json',
+    type: 'object',
+    properties: {
+        title: stringSchema,
+        description: stringSchema,
+        actor: stringSchema
+    },
+    additionalProperties: true
+};
+/** Canonical JSON Schema export used by Cloud, fixtures, and replay tooling. */
+export const EVENT_FRAME_V1_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://agentworkforce.dev/schemas/events/event-frame-v1.json',
+    title: 'EventFrameV1',
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'schemaVersion',
+        'id',
+        'workspace',
+        'type',
+        'contractVersion',
+        'occurredAt',
+        'attempt',
+        'resource',
+        'summary'
+    ],
+    properties: {
+        schemaVersion: { const: 1 },
+        id: nonEmptyStringSchema,
+        workspace: nonEmptyStringSchema,
+        type: nonEmptyStringSchema,
+        contractVersion: { type: 'integer', minimum: 1 },
+        occurredAt: { type: 'string', format: 'date-time' },
+        attempt: { type: 'integer', minimum: 1 },
+        resource: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['path', 'kind', 'id', 'provider'],
+            properties: {
+                path: stringSchema,
+                kind: nonEmptyStringSchema,
+                id: nonEmptyStringSchema,
+                provider: nonEmptyStringSchema
+            }
+        },
+        summary: EVENT_SUMMARY_SCHEMA,
+        delivery: {
+            type: 'object',
+            additionalProperties: false,
+            properties: { id: stringSchema, dedupeKey: stringSchema }
+        },
+        payload: {},
+        paths: { type: 'array', items: stringSchema },
+        digest: stringSchema,
+        schedule: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['name'],
+            properties: {
+                name: nonEmptyStringSchema,
+                cron: stringSchema,
+                timezone: stringSchema,
+                scheduledFor: { type: 'string', format: 'date-time' }
+            }
+        },
+        message: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                channel: stringSchema,
+                messageId: stringSchema,
+                threadId: stringSchema
+            }
+        },
+        extensions: { type: 'object', additionalProperties: true }
+    }
+};
+/** Derived from the schema so parsers and exported schema cannot drift. */
+export const EVENT_FRAME_V1_FIELDS = Object.freeze(Object.keys(EVENT_FRAME_V1_SCHEMA.properties));
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAW,CAAC;AACjD,MAAM,oBAAoB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAW,CAAC;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE,8DAA8D;IACnE,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,YAAY;QACzB,KAAK,EAAE,YAAY;KACpB;IACD,oBAAoB,EAAE,IAAI;CACG,CAAC;AAEhC,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,8CAA8C;IACvD,GAAG,EAAE,+DAA+D;IACpE,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR,eAAe;QACf,IAAI;QACJ,WAAW;QACX,MAAM;QACN,iBAAiB;QACjB,YAAY;QACZ,SAAS;QACT,UAAU;QACV,SAAS;KACV;IACD,UAAU,EAAE;QACV,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QAC3B,EAAE,EAAE,oBAAoB;QACxB,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE,oBAAoB;QAC1B,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAChD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;QACnD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACxC,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC;YAC5C,UAAU,EAAE;gBACV,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,oBAAoB;gBAC1B,EAAE,EAAE,oBAAoB;gBACxB,QAAQ,EAAE,oBAAoB;aAC/B;SACF;QACD,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE;SAC1D;QACD,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE;QAC7C,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,UAAU,EAAE;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,YAAY;gBACtB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;aACtD;SACF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACV,OAAO,EAAE,YAAY;gBACrB,SAAS,EAAE,YAAY;gBACvB,QAAQ,EAAE,YAAY;aACvB;SACF;QACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;KAC3D;CAC4B,CAAC;AAEhC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAChD,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CACgB,CAAC"}