@sprinterai/runtime 0.7.1 → 0.9.0

package/dist/external-data/external-data-receiver.d.ts

@@ -0,0 +1,43 @@
+import type { ExternalDataStore } from '@sprinterai/core';
+export interface ExternalDataReceiverConfig {
+    store: ExternalDataStore;
+}
+export interface ReceiveWebhookOptions {
+    /** Token embedded in the webhook URL — used to look up the data source. */
+    token: string;
+    /** Raw request body string (pre-parsed). */
+    rawBody: string;
+    /** Request headers for signature verification. Keys should be lowercase. */
+    headers: Record<string, string>;
+}
+export interface WebhookReceiveResult {
+    success: boolean;
+    pointsCreated: number;
+    error?: string;
+}
+export interface ExternalDataReceiver {
+    receiveWebhook(opts: ReceiveWebhookOptions): Promise<WebhookReceiveResult>;
+}
+/**
+ * Create a framework-agnostic external data receiver for webhook ingestion.
+ *
+ * Handles:
+ * - Source lookup by token
+ * - Optional HMAC-SHA256 signature verification
+ * - Zod payload validation
+ * - Bulk data point insertion via the store
+ *
+ * @example
+ * ```ts
+ * const receiver = createExternalDataReceiver({ store });
+ *
+ * // In your POST /api/webhooks/:token handler:
+ * const result = await receiver.receiveWebhook({
+ *   token: params.token,
+ *   rawBody: await request.text(),
+ *   headers: Object.fromEntries(request.headers),
+ * });
+ * ```
+ */
+export declare function createExternalDataReceiver(config: ExternalDataReceiverConfig): ExternalDataReceiver;
+//# sourceMappingURL=external-data-receiver.d.ts.map

package/dist/external-data/external-data-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-data-receiver.d.ts","sourceRoot":"","sources":["../../src/external-data/external-data-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,kBAAkB,CAAC;AAOhG,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC5E;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,oBAAoB,CAgEtB"}

package/dist/external-data/external-data-receiver.js

@@ -0,0 +1,81 @@
+import { WebhookPayloadSchema } from '@sprinterai/core';
+import { verifySignature } from '../webhook/webhook-signer.js';
+// ─── Factory ──────────────────────────────────────────────────
+/**
+ * Create a framework-agnostic external data receiver for webhook ingestion.
+ *
+ * Handles:
+ * - Source lookup by token
+ * - Optional HMAC-SHA256 signature verification
+ * - Zod payload validation
+ * - Bulk data point insertion via the store
+ *
+ * @example
+ * ```ts
+ * const receiver = createExternalDataReceiver({ store });
+ *
+ * // In your POST /api/webhooks/:token handler:
+ * const result = await receiver.receiveWebhook({
+ *   token: params.token,
+ *   rawBody: await request.text(),
+ *   headers: Object.fromEntries(request.headers),
+ * });
+ * ```
+ */
+export function createExternalDataReceiver(config) {
+    const { store } = config;
+    return {
+        async receiveWebhook(opts) {
+            const { token, rawBody, headers } = opts;
+            // 1. Look up data source by token
+            const source = await store.getDataSourceByToken(token);
+            if (!source) {
+                return { success: false, pointsCreated: 0, error: 'Unknown token' };
+            }
+            if (!source.enabled) {
+                return { success: false, pointsCreated: 0, error: 'Data source is disabled' };
+            }
+            // 2. Verify signature if a secret is configured
+            if (source.signature_secret) {
+                const headerKey = source.signature_header.toLowerCase();
+                const signature = headers[headerKey];
+                if (!signature) {
+                    return { success: false, pointsCreated: 0, error: 'Missing signature header' };
+                }
+                const valid = verifySignature(rawBody, signature, source.signature_secret);
+                if (!valid) {
+                    return { success: false, pointsCreated: 0, error: 'Invalid signature' };
+                }
+            }
+            // 3. Parse and validate payload
+            let payload;
+            try {
+                const raw = JSON.parse(rawBody);
+                payload = WebhookPayloadSchema.parse(raw);
+            }
+            catch {
+                return { success: false, pointsCreated: 0, error: 'Invalid payload format' };
+            }
+            // 4. Build data point records
+            const now = new Date().toISOString();
+            const points = payload.metrics.map((metric) => ({
+                data_source_id: source.id,
+                tenant_id: source.tenant_id,
+                metric_key: metric.key,
+                label: metric.label,
+                value: metric.value,
+                metadata: {
+                    change: metric.change,
+                    icon: metric.icon,
+                    unit: metric.unit,
+                    group: metric.group,
+                },
+                recorded_at: metric.recorded_at ?? now,
+            }));
+            // 5. Persist data points
+            const created = await store.recordDataPoints(points);
+            return { success: true, pointsCreated: created.length };
+        },
+    };
+}
+//# sourceMappingURL=external-data-receiver.js.map

package/dist/external-data/external-data-receiver.js.map

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

package/dist/external-data/external-data-receiver.test.d.ts

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

package/dist/external-data/external-data-receiver.test.d.ts.map

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

package/dist/external-data/external-data-receiver.test.js

@@ -0,0 +1,189 @@
+import { describe, it, expect, vi } from 'vitest';
+import { signPayload } from '../webhook/webhook-signer.js';
+import { createExternalDataReceiver } from './external-data-receiver.js';
+function makeSource(overrides = {}) {
+    return {
+        id: 'ds-1',
+        tenant_id: 'tenant-1',
+        name: 'Revenue Hook',
+        description: null,
+        source_type: 'webhook',
+        token: 'tok_abc123',
+        signature_secret: null,
+        signature_header: 'x-signature',
+        enabled: true,
+        last_received_at: null,
+        push_count: 0,
+        created_at: '2026-01-01T00:00:00Z',
+        updated_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makePoint(overrides = {}) {
+    return {
+        id: 'dp-1',
+        data_source_id: 'ds-1',
+        tenant_id: 'tenant-1',
+        metric_key: 'users',
+        label: 'Total Users',
+        value: 100,
+        metadata: {},
+        recorded_at: '2026-04-03T12:00:00Z',
+        created_at: '2026-04-03T12:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(source = makeSource()) {
+    return {
+        listDataSources: vi.fn(async () => (source ? [source] : [])),
+        getDataSourceByToken: vi.fn(async () => source),
+        createDataSource: vi.fn(async () => source),
+        updateDataSource: vi.fn(async () => source),
+        deleteDataSource: vi.fn(async () => undefined),
+        recordDataPoints: vi.fn(async () => [makePoint()]),
+        getLatestMetrics: vi.fn(async () => [makePoint()]),
+        getMetricHistory: vi.fn(async () => [makePoint()]),
+    };
+}
+const validPayload = JSON.stringify({
+    metrics: [{ key: 'users', label: 'Total Users', value: 100 }],
+});
+describe('createExternalDataReceiver - receiveWebhook', () => {
+    it('returns error for unknown token', async () => {
+        const store = makeStore(null);
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'bad_token',
+            rawBody: validPayload,
+            headers: {},
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Unknown token');
+        expect(result.pointsCreated).toBe(0);
+    });
+    it('returns error for disabled source', async () => {
+        const store = makeStore(makeSource({ enabled: false }));
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: {},
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Data source is disabled');
+    });
+    it('succeeds for enabled source without signature verification', async () => {
+        const store = makeStore();
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: {},
+        });
+        expect(result.success).toBe(true);
+        expect(result.pointsCreated).toBe(1);
+        expect(result.error).toBeUndefined();
+    });
+    it('verifies valid HMAC signature', async () => {
+        const secret = 'mysecret';
+        const source = makeSource({ signature_secret: secret, signature_header: 'x-signature' });
+        const store = makeStore(source);
+        const receiver = createExternalDataReceiver({ store });
+        const signature = signPayload(validPayload, secret);
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: { 'x-signature': signature },
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects missing signature header when secret is configured', async () => {
+        const source = makeSource({ signature_secret: 'mysecret' });
+        const store = makeStore(source);
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: {},
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Missing signature header');
+    });
+    it('rejects invalid HMAC signature', async () => {
+        const source = makeSource({ signature_secret: 'mysecret' });
+        const store = makeStore(source);
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: { 'x-signature': 'sha256=badhash' },
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Invalid signature');
+    });
+    it('is case-insensitive for signature header lookup', async () => {
+        const secret = 'mysecret';
+        const source = makeSource({ signature_secret: secret, signature_header: 'X-Signature' });
+        const store = makeStore(source);
+        const receiver = createExternalDataReceiver({ store });
+        const signature = signPayload(validPayload, secret);
+        // Store normalizes header to lowercase before lookup
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: validPayload,
+            headers: { 'x-signature': signature },
+        });
+        expect(result.success).toBe(true);
+    });
+    it('returns error for invalid JSON body', async () => {
+        const store = makeStore();
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: 'not-json',
+            headers: {},
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Invalid payload format');
+    });
+    it('returns error for payload failing schema validation', async () => {
+        const store = makeStore();
+        const receiver = createExternalDataReceiver({ store });
+        const result = await receiver.receiveWebhook({
+            token: 'tok_abc123',
+            rawBody: JSON.stringify({ metrics: [] }), // empty array violates min(1)
+            headers: {},
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('Invalid payload format');
+    });
+    it('passes correct data points to store', async () => {
+        const store = makeStore();
+        const receiver = createExternalDataReceiver({ store });
+        const payload = JSON.stringify({
+            metrics: [
+                { key: 'revenue', label: 'Revenue', value: 1500, unit: '$', change: '+5%' },
+                { key: 'users', label: 'Users', value: 200 },
+            ],
+        });
+        await receiver.receiveWebhook({ token: 'tok_abc123', rawBody: payload, headers: {} });
+        expect(store.recordDataPoints).toHaveBeenCalledTimes(1);
+        const [points] = store.recordDataPoints.mock.calls[0];
+        expect(points).toHaveLength(2);
+        expect(points[0]).toMatchObject({ metric_key: 'revenue', value: 1500 });
+        expect(points[0].metadata).toMatchObject({ unit: '$', change: '+5%' });
+        expect(points[1]).toMatchObject({ metric_key: 'users', value: 200 });
+    });
+    it('uses provided recorded_at when present', async () => {
+        const store = makeStore();
+        const receiver = createExternalDataReceiver({ store });
+        const recordedAt = '2026-01-15T10:00:00Z';
+        const payload = JSON.stringify({
+            metrics: [{ key: 'k', label: 'L', value: 1, recorded_at: recordedAt }],
+        });
+        await receiver.receiveWebhook({ token: 'tok_abc123', rawBody: payload, headers: {} });
+        const [points] = store.recordDataPoints.mock.calls[0];
+        expect(points[0].recorded_at).toBe(recordedAt);
+    });
+});
+//# sourceMappingURL=external-data-receiver.test.js.map

package/dist/external-data/external-data-receiver.test.js.map

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

package/dist/external-data/extract-by-path.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolve a dot-notation path against a data object.
+ *
+ * Strips a leading `$.` prefix (JSONPath convention) before resolving.
+ * Returns `undefined` for missing keys, null values, or non-object inputs.
+ *
+ * @example
+ * extractByPath({ data: { metrics: [1, 2] } }, 'data.metrics') // [1, 2]
+ * extractByPath({ data: { metrics: [1, 2] } }, '$.data.metrics') // [1, 2]
+ * extractByPath({ foo: 'bar' }, 'missing.key') // undefined
+ */
+export declare function extractByPath(data: unknown, path: string): unknown;
+//# sourceMappingURL=extract-by-path.d.ts.map

package/dist/external-data/extract-by-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-by-path.d.ts","sourceRoot":"","sources":["../../src/external-data/extract-by-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAclE"}

package/dist/external-data/extract-by-path.js

@@ -0,0 +1,25 @@
+/**
+ * Resolve a dot-notation path against a data object.
+ *
+ * Strips a leading `$.` prefix (JSONPath convention) before resolving.
+ * Returns `undefined` for missing keys, null values, or non-object inputs.
+ *
+ * @example
+ * extractByPath({ data: { metrics: [1, 2] } }, 'data.metrics') // [1, 2]
+ * extractByPath({ data: { metrics: [1, 2] } }, '$.data.metrics') // [1, 2]
+ * extractByPath({ foo: 'bar' }, 'missing.key') // undefined
+ */
+export function extractByPath(data, path) {
+    // Strip leading "$." JSONPath prefix
+    const normalizedPath = path.startsWith('$.') ? path.slice(2) : path;
+    const segments = normalizedPath.split('.');
+    let current = data;
+    for (const segment of segments) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+//# sourceMappingURL=extract-by-path.js.map

package/dist/external-data/extract-by-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-by-path.js","sourceRoot":"","sources":["../../src/external-data/extract-by-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,IAAY;IACvD,qCAAqC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7E,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/external-data/extract-by-path.test.d.ts

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

package/dist/external-data/extract-by-path.test.d.ts.map

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

package/dist/external-data/extract-by-path.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from 'vitest';
+import { extractByPath } from './extract-by-path.js';
+describe('extractByPath', () => {
+    it('resolves a top-level key', () => {
+        expect(extractByPath({ foo: 'bar' }, 'foo')).toBe('bar');
+    });
+    it('resolves a nested path', () => {
+        expect(extractByPath({ data: { metrics: [1, 2, 3] } }, 'data.metrics')).toEqual([1, 2, 3]);
+    });
+    it('strips leading $. prefix', () => {
+        expect(extractByPath({ data: { value: 42 } }, '$.data.value')).toBe(42);
+    });
+    it('returns undefined for missing top-level key', () => {
+        expect(extractByPath({ foo: 'bar' }, 'missing')).toBeUndefined();
+    });
+    it('returns undefined for missing nested key', () => {
+        expect(extractByPath({ a: { b: 1 } }, 'a.c')).toBeUndefined();
+    });
+    it('returns undefined when traversing through null', () => {
+        expect(extractByPath({ a: null }, 'a.b')).toBeUndefined();
+    });
+    it('returns undefined when traversing through undefined', () => {
+        expect(extractByPath({ a: undefined }, 'a.b')).toBeUndefined();
+    });
+    it('returns undefined when traversing through a primitive', () => {
+        expect(extractByPath({ a: 42 }, 'a.b')).toBeUndefined();
+    });
+    it('returns undefined for non-object input', () => {
+        expect(extractByPath(null, 'foo')).toBeUndefined();
+        expect(extractByPath(undefined, 'foo')).toBeUndefined();
+        expect(extractByPath('string', 'foo')).toBeUndefined();
+        expect(extractByPath(42, 'foo')).toBeUndefined();
+    });
+    it('returns the full object for a single-segment path', () => {
+        const arr = [1, 2, 3];
+        expect(extractByPath({ items: arr }, 'items')).toEqual(arr);
+    });
+    it('resolves deeply nested paths', () => {
+        const data = { a: { b: { c: { d: 'deep' } } } };
+        expect(extractByPath(data, 'a.b.c.d')).toBe('deep');
+    });
+    it('handles numeric string keys', () => {
+        const data = { '0': { value: 99 } };
+        expect(extractByPath(data, '0.value')).toBe(99);
+    });
+});
+//# sourceMappingURL=extract-by-path.test.js.map

package/dist/external-data/extract-by-path.test.js.map

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

package/dist/external-data/index.d.ts

@@ -0,0 +1,4 @@
+export { extractByPath } from './extract-by-path.js';
+export type { ExternalDataReceiverConfig, ReceiveWebhookOptions, WebhookReceiveResult, ExternalDataReceiver, } from './external-data-receiver.js';
+export { createExternalDataReceiver } from './external-data-receiver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/external-data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/external-data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/external-data/index.js

@@ -0,0 +1,3 @@
+export { extractByPath } from './extract-by-path.js';
+export { createExternalDataReceiver } from './external-data-receiver.js';
+//# sourceMappingURL=index.js.map

package/dist/external-data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/external-data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQlD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/feed/digest.d.ts

@@ -0,0 +1,35 @@
+import type { ActivityStore } from '@sprinterai/core';
+import type { DigestConfig, FeedDigest } from './types.js';
+/**
+ * Resolve a daily digest of high-impact activities.
+ *
+ * Generates a summary of the most important activities from the past 24 hours.
+ * Useful for daily email digests, notifications, and summaries.
+ *
+ * Flow:
+ * 1. Query activities from the past 24 hours
+ * 2. Rank by importance + recency
+ * 3. Filter by score threshold (optional)
+ * 4. Select top N items
+ * 5. Compute summary statistics
+ * 6. Return FeedDigest with items and metadata
+ *
+ * @param store ActivityStore implementation
+ * @param config Digest configuration
+ * @returns FeedDigest with items and summary
+ * @throws Error if store query fails
+ */
+export declare function resolveDigest(store: ActivityStore, config: DigestConfig): Promise<FeedDigest>;
+/**
+ * Build a multi-day digest.
+ *
+ * Generates a digest spanning multiple days.
+ * Useful for weekly/monthly summaries.
+ *
+ * @param store ActivityStore
+ * @param config Digest config
+ * @param days Number of days to include (default 7 for weekly)
+ * @returns FeedDigest combining items from multiple days
+ */
+export declare function resolveMultiDayDigest(store: ActivityStore, config: DigestConfig, days?: number): Promise<FeedDigest>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/feed/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/feed/digest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAY,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC,CAiFrB;AA2JD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,UAAU,CAAC,CAgErB"}