opentasks 0.0.1 → 0.0.2

package/dist/materialization/graph-id.js

@@ -0,0 +1,163 @@
+/**
+ * Graph ID Resolution
+ *
+ * Resolves a stable, unique graphId for namespacing archives.
+ * Uses a fallback chain: explicit config → location name → git remote → directory name.
+ */
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+/**
+ * Slugify a string for use as a directory name.
+ * Replaces non-alphanumeric characters with hyphens,
+ * collapses runs, trims edges.
+ */
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64);
+}
+/**
+ * Slugify a git remote URL into a directory-safe string.
+ *
+ * Examples:
+ *   git@github.com:my-org/my-repo.git → my-org--my-repo
+ *   https://github.com/my-org/my-repo → my-org--my-repo
+ */
+export function slugifyRemoteUrl(url) {
+    // Strip protocol and .git suffix
+    let cleaned = url.replace(/^(https?:\/\/|git@|ssh:\/\/[^@]+@)/, '').replace(/\.git$/, '');
+    // For SSH-style URLs: github.com:org/repo → org/repo
+    const colonIdx = cleaned.indexOf(':');
+    if (colonIdx !== -1 && !cleaned.includes('/')) {
+        cleaned = cleaned.slice(colonIdx + 1);
+    }
+    else if (colonIdx !== -1) {
+        // github.com:org/repo
+        const afterHost = cleaned.slice(colonIdx + 1);
+        if (afterHost && !afterHost.startsWith('/')) {
+            cleaned = afterHost;
+        }
+        else {
+            // https-style: github.com/org/repo — strip host
+            const parts = cleaned.split('/');
+            if (parts.length > 2) {
+                cleaned = parts.slice(1).join('/');
+            }
+        }
+    }
+    else {
+        // Pure path: github.com/org/repo — strip host
+        const parts = cleaned.split('/');
+        if (parts.length > 2) {
+            cleaned = parts.slice(1).join('/');
+        }
+    }
+    // Replace / with -- for readability
+    return slugify(cleaned.replace(/\//g, '--'));
+}
+/**
+ * Get the git remote URL for a remote name.
+ * Returns null if the remote doesn't exist or git isn't available.
+ */
+export function getGitRemoteUrl(gitDir, remoteName = 'origin') {
+    try {
+        const repoRoot = path.dirname(gitDir);
+        const result = execSync(`git -C "${repoRoot}" remote get-url ${remoteName}`, {
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the current HEAD commit SHA.
+ */
+export function getGitHead(gitDir) {
+    try {
+        const repoRoot = path.dirname(gitDir);
+        const result = execSync(`git -C "${repoRoot}" rev-parse HEAD`, {
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the current branch name.
+ */
+export function getGitBranch(gitDir) {
+    try {
+        const repoRoot = path.dirname(gitDir);
+        const result = execSync(`git -C "${repoRoot}" rev-parse --abbrev-ref HEAD`, {
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const branch = result.trim();
+        return branch === 'HEAD' ? null : branch;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the git directory for a given .opentasks path.
+ * Handles worktrees correctly.
+ */
+export function resolveGitDir(opentasksPath) {
+    try {
+        const repoRoot = path.dirname(opentasksPath);
+        const result = execSync(`git -C "${repoRoot}" rev-parse --git-dir`, {
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const gitDir = result.trim();
+        return path.isAbsolute(gitDir) ? gitDir : path.resolve(repoRoot, gitDir);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the graphId for a given opentasks location.
+ *
+ * Fallback chain:
+ * 1. Explicit config (highest priority)
+ * 2. Location name from config
+ * 3. Derive from git remote URL
+ * 4. Derive from directory name
+ */
+export function resolveGraphId(options) {
+    const { explicitGraphId, locationName, opentasksPath } = options;
+    // 1. Explicit config
+    if (explicitGraphId) {
+        return explicitGraphId;
+    }
+    // 2. Location name
+    if (locationName) {
+        return slugify(locationName);
+    }
+    // 3. Derive from git remote URL
+    const gitDir = resolveGitDir(opentasksPath);
+    if (gitDir) {
+        const remoteUrl = getGitRemoteUrl(gitDir);
+        if (remoteUrl) {
+            return slugifyRemoteUrl(remoteUrl);
+        }
+    }
+    // 4. Derive from directory name
+    const repoRoot = path.dirname(opentasksPath);
+    return slugify(path.basename(repoRoot));
+}
+//# sourceMappingURL=graph-id.js.map

package/dist/materialization/graph-id.js.map

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

package/dist/materialization/http-remote-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP Webhook Remote Store
+ *
+ * Posts materialization snapshots to an HTTP endpoint.
+ * Supports basic authentication, custom headers, and event filtering.
+ */
+import type { RemoteStore, RemoteStoreConfig } from './types.js';
+/**
+ * Create an HTTP webhook remote store
+ */
+export declare function createHttpRemoteStore(storeConfig: RemoteStoreConfig): RemoteStore;
+//# sourceMappingURL=http-remote-store.d.ts.map

package/dist/materialization/http-remote-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-remote-store.d.ts","sourceRoot":"","sources":["../../src/materialization/http-remote-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AA2BpB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,WAAW,CA+IjF"}

package/dist/materialization/http-remote-store.js

@@ -0,0 +1,143 @@
+/**
+ * HTTP Webhook Remote Store
+ *
+ * Posts materialization snapshots to an HTTP endpoint.
+ * Supports basic authentication, custom headers, and event filtering.
+ */
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create an HTTP webhook remote store
+ */
+export function createHttpRemoteStore(storeConfig) {
+    const config = storeConfig.config;
+    const url = config.url;
+    const headers = config.headers ?? {};
+    const timeout = config.timeout ?? 10000;
+    const method = config.method ?? 'POST';
+    const batchMode = config.batchMode ?? 'individual';
+    let lastArchiveAt;
+    let lastError;
+    if (!url) {
+        throw new Error('HTTP remote store requires a "url" in config');
+    }
+    /**
+     * POST a snapshot to the webhook
+     */
+    async function postSnapshot(snapshot) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+                body: JSON.stringify(snapshot),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                const errorMsg = `HTTP ${response.status}: ${errorText || response.statusText}`;
+                lastError = errorMsg;
+                return { stored: false, uri: snapshot.uri, error: errorMsg };
+            }
+            lastArchiveAt = new Date().toISOString();
+            lastError = undefined;
+            return { stored: true, uri: snapshot.uri };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            lastError = errorMsg;
+            return { stored: false, uri: snapshot.uri, error: errorMsg };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return {
+        name: storeConfig.name,
+        type: storeConfig.type,
+        enabled: storeConfig.enabled,
+        events: storeConfig.events,
+        async archive(snapshot) {
+            return postSnapshot(snapshot);
+        },
+        async archiveBatch(snapshots) {
+            if (batchMode === 'array') {
+                // Send all snapshots as a single array POST
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), timeout * 2);
+                try {
+                    const response = await fetch(url, {
+                        method,
+                        headers: {
+                            'Content-Type': 'application/json',
+                            ...headers,
+                        },
+                        body: JSON.stringify(snapshots),
+                        signal: controller.signal,
+                    });
+                    const stored = response.ok;
+                    const results = snapshots.map((s) => ({
+                        stored,
+                        uri: s.uri,
+                        error: stored ? undefined : `HTTP ${response.status}`,
+                    }));
+                    return {
+                        results,
+                        successCount: stored ? snapshots.length : 0,
+                        failureCount: stored ? 0 : snapshots.length,
+                    };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    return {
+                        results: snapshots.map((s) => ({ stored: false, uri: s.uri, error: errorMsg })),
+                        successCount: 0,
+                        failureCount: snapshots.length,
+                    };
+                }
+                finally {
+                    clearTimeout(timer);
+                }
+            }
+            // Individual mode: send each snapshot separately
+            const results = [];
+            for (const snapshot of snapshots) {
+                results.push(await postSnapshot(snapshot));
+            }
+            return {
+                results,
+                successCount: results.filter((r) => r.stored).length,
+                failureCount: results.filter((r) => !r.stored).length,
+            };
+        },
+        async retrieve(_uri) {
+            // HTTP webhook stores are write-only by default.
+            // A read-capable implementation would need a GET endpoint.
+            return null;
+        },
+        async list(_filter) {
+            // HTTP webhook stores don't support listing.
+            return [];
+        },
+        async initialize() {
+            // Validate URL is reachable (optional health check)
+        },
+        async close() {
+            // Nothing to close for HTTP
+        },
+        async status() {
+            return {
+                healthy: !lastError,
+                message: lastError ? `Last error: ${lastError}` : 'OK',
+                lastArchiveAt,
+                lastError,
+            };
+        },
+    };
+}
+//# sourceMappingURL=http-remote-store.js.map

package/dist/materialization/http-remote-store.js.map

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

package/dist/materialization/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Materialization Stores — public API
+ *
+ * Git-native archival and rematerialization for external node snapshots.
+ */
+export type { MaterializationSnapshot, SessionSnapshot, CheckpointSnapshot, EdgeSnapshot, SnapshotProvenance, ArchivePolicy, GitArchiveStoreConfig, MaterializationStore, RemoteStore, RemoteStoreConfig, MaterializationArchiver, MaterializationArchiverConfig, ArchiveResult, BatchArchiveResult, ArchiveFilter, ArchiveListEntry, ArchiveEventResult, RematerializeAllResult, StoreStatus, GitArchiveStoreExtended, MaterializationProvider, } from './types.js';
+export { DEFAULT_ARCHIVE_POLICY, DEFAULT_GIT_ARCHIVE_CONFIG } from './types.js';
+export { createGitArchiveStore } from './git-archive-store.js';
+export { createMaterializationArchiver } from './archiver.js';
+export { createHttpRemoteStore } from './http-remote-store.js';
+export { createGitRemoteStore } from './git-remote-store.js';
+export { createRemoteStoresFromConfig, registerRemoteStoreFactory, } from './remote-store-factory.js';
+export { buildSnapshot, buildSessionSnapshot, buildCheckpointSnapshot, buildEdgeSnapshots, buildProvenance, } from './snapshot.js';
+export { resolveGraphId, slugify, slugifyRemoteUrl, getGitRemoteUrl, getGitBranch, getGitHead, resolveGitDir, } from './graph-id.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/materialization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/materialization/index.js

@@ -0,0 +1,17 @@
+/**
+ * Materialization Stores — public API
+ *
+ * Git-native archival and rematerialization for external node snapshots.
+ */
+export { DEFAULT_ARCHIVE_POLICY, DEFAULT_GIT_ARCHIVE_CONFIG } from './types.js';
+// Factories
+export { createGitArchiveStore } from './git-archive-store.js';
+export { createMaterializationArchiver } from './archiver.js';
+export { createHttpRemoteStore } from './http-remote-store.js';
+export { createGitRemoteStore } from './git-remote-store.js';
+export { createRemoteStoresFromConfig, registerRemoteStoreFactory, } from './remote-store-factory.js';
+// Snapshot assembly
+export { buildSnapshot, buildSessionSnapshot, buildCheckpointSnapshot, buildEdgeSnapshots, buildProvenance, } from './snapshot.js';
+// Graph ID resolution
+export { resolveGraphId, slugify, slugifyRemoteUrl, getGitRemoteUrl, getGitBranch, getGitHead, resolveGitDir, } from './graph-id.js';
+//# sourceMappingURL=index.js.map

package/dist/materialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/materialization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAEhF,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EACL,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/materialization/remote-store-factory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Remote Store Factory
+ *
+ * Creates RemoteStore instances from configuration.
+ * Resolves store type to the appropriate implementation.
+ */
+import type { RemoteStore, RemoteStoreConfig } from './types.js';
+/**
+ * Register a custom remote store factory
+ */
+export declare function registerRemoteStoreFactory(type: string, factory: (config: RemoteStoreConfig) => RemoteStore): void;
+/**
+ * Create remote stores from an array of config entries.
+ * Skips unknown store types with a warning (non-fatal).
+ */
+export declare function createRemoteStoresFromConfig(configs: RemoteStoreConfig[]): RemoteStore[];
+//# sourceMappingURL=remote-store-factory.d.ts.map

package/dist/materialization/remote-store-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-store-factory.d.ts","sourceRoot":"","sources":["../../src/materialization/remote-store-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAajE;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,WAAW,GAClD,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,WAAW,EAAE,CAoBxF"}

package/dist/materialization/remote-store-factory.js

@@ -0,0 +1,46 @@
+/**
+ * Remote Store Factory
+ *
+ * Creates RemoteStore instances from configuration.
+ * Resolves store type to the appropriate implementation.
+ */
+import { createHttpRemoteStore } from './http-remote-store.js';
+import { createGitRemoteStore } from './git-remote-store.js';
+/**
+ * Registry of remote store factories by type
+ */
+const storeFactories = new Map([
+    ['http', createHttpRemoteStore],
+    ['webhook', createHttpRemoteStore],
+    ['git-remote', createGitRemoteStore],
+]);
+/**
+ * Register a custom remote store factory
+ */
+export function registerRemoteStoreFactory(type, factory) {
+    storeFactories.set(type, factory);
+}
+/**
+ * Create remote stores from an array of config entries.
+ * Skips unknown store types with a warning (non-fatal).
+ */
+export function createRemoteStoresFromConfig(configs) {
+    const stores = [];
+    for (const config of configs) {
+        if (!config.enabled)
+            continue;
+        const factory = storeFactories.get(config.type);
+        if (!factory) {
+            // Unknown store type — skip with warning
+            continue;
+        }
+        try {
+            stores.push(factory(config));
+        }
+        catch {
+            // Factory error — skip this store
+        }
+    }
+    return stores;
+}
+//# sourceMappingURL=remote-store-factory.js.map

package/dist/materialization/remote-store-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-store-factory.js","sourceRoot":"","sources":["../../src/materialization/remote-store-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAqD;IACjF,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAC/B,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAClC,CAAC,YAAY,EAAE,oBAAoB,CAAC;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,OAAmD;IAEnD,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAA4B;IACvE,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAS;QAE9B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,yCAAyC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/materialization/snapshot.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Snapshot Assembly
+ *
+ * Builds self-contained MaterializationSnapshots from GraphStore nodes and edges.
+ * Snapshots contain everything needed to reconstruct the node in a fresh graph.
+ */
+import type { GraphStore } from '../graph/store.js';
+import type { ExternalNode } from '../schema/nodes.js';
+import type { MaterializationSnapshot, SessionSnapshot, CheckpointSnapshot, EdgeSnapshot, SnapshotProvenance } from './types.js';
+/**
+ * Build provenance metadata for a snapshot
+ */
+export declare function buildProvenance(options: {
+    graphId: string;
+    opentasksPath: string;
+}): SnapshotProvenance;
+/**
+ * Build portable edge snapshots from graph edges.
+ * Converts internal node IDs to URIs for cross-graph portability.
+ */
+export declare function buildEdgeSnapshots(nodeId: string, store: GraphStore): Promise<EdgeSnapshot[]>;
+/**
+ * Build a session snapshot from a session ExternalNode
+ */
+export declare function buildSessionSnapshot(node: ExternalNode, store: GraphStore, provenance: SnapshotProvenance): Promise<SessionSnapshot>;
+/**
+ * Build a checkpoint snapshot from a checkpoint ExternalNode
+ */
+export declare function buildCheckpointSnapshot(node: ExternalNode, store: GraphStore, provenance: SnapshotProvenance): Promise<CheckpointSnapshot>;
+/**
+ * Build a generic snapshot for any ExternalNode
+ */
+export declare function buildSnapshot(node: ExternalNode, store: GraphStore, provenance: SnapshotProvenance): Promise<MaterializationSnapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/materialization/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/materialization/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,kBAAkB,CAWrB;AAkCD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8BzB;AAMD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAsB7B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA6BlC"}