@duckcodeailabs/dql-project 0.8.16 → 0.10.0

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export { RegistrySync } from './sync.js';
 export type { SyncResult, SyncOptions, ParsedBlock } from './sync.js';
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
+export { ManifestCache } from './manifest-cache.js';
+export type { TrackedFile, CacheHit, CacheMiss, CacheLookup, ManifestCacheOptions, } from './manifest-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,4 +3,5 @@ export { VersionManager } from './version-manager.js';
 export { RegistrySync } from './sync.js';
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
+export { ManifestCache } from './manifest-cache.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/manifest-cache.d.ts

@@ -0,0 +1,63 @@
+/** A tracked input file — the cache hashes its mtime+size cheaply, content on demand. */
+export interface TrackedFile {
+    /** Relative path from project root (stable cache key component). */
+    path: string;
+    /** SHA-256 of file contents. Computed by the cache if omitted. */
+    contentHash?: string;
+}
+/** Result of a fingerprint lookup. */
+export interface CacheHit<T> {
+    hit: true;
+    value: T;
+    fingerprint: string;
+    builtAt: string;
+}
+export interface CacheMiss {
+    hit: false;
+    /** Files whose content hash differs from the last stored build (empty if this is a cold cache). */
+    changedFiles: string[];
+}
+export type CacheLookup<T> = CacheHit<T> | CacheMiss;
+export interface ManifestCacheOptions {
+    /** Path to the SQLite file. Caller is responsible for choosing a project-scoped location. */
+    path: string;
+}
+/**
+ * SQLite-backed cache for compiled manifests.
+ *
+ * Schema
+ * - `manifest_entries`: one row per fingerprint, holds the serialized manifest
+ * - `file_hashes`: the last-seen content hash for each tracked file, used to
+ *   compute a dirty set on cold paths
+ */
+export declare class ManifestCache {
+    private db;
+    constructor(options: ManifestCacheOptions);
+    private initSchema;
+    /**
+     * Compute a stable fingerprint over a set of tracked files. The caller
+     * should include every file whose contents could change the manifest
+     * (all `.dql`, `.dqlnb`, semantic YAML, and dbt `manifest.json`).
+     *
+     * Fingerprint = sha256 of `path\0hash\n` joined for a lexicographically
+     * sorted file list. Missing content hashes are filled in from disk.
+     */
+    fingerprint(files: TrackedFile[]): string;
+    /**
+     * Look up a previously-cached manifest by fingerprint. On miss, returns the
+     * set of file paths whose current content hash differs from the last stored
+     * hash — callers can use this to rebuild only affected subgraphs.
+     */
+    lookup<T>(fingerprint: string, files: TrackedFile[]): CacheLookup<T>;
+    /**
+     * Persist a newly-built manifest under `fingerprint`, and record the per-file
+     * content hashes so the next miss can report a precise dirty set.
+     */
+    put<T>(fingerprint: string, value: T, files: TrackedFile[]): void;
+    /** Return the files whose current content hash differs from the stored one. */
+    diffFiles(files: TrackedFile[]): string[];
+    /** Clear all cached manifests and file hashes. Useful for `dql compile --no-cache`. */
+    clear(): void;
+    close(): void;
+}
+//# sourceMappingURL=manifest-cache.d.ts.map

package/dist/manifest-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-cache.d.ts","sourceRoot":"","sources":["../src/manifest-cache.ts"],"names":[],"mappings":"AAkBA,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,KAAK,CAAC;IACX,mGAAmG;IACnG,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AACD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;gBAElB,OAAO,EAAE,oBAAoB;IAOzC,OAAO,CAAC,UAAU;IAgBlB;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;IAezC;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC;IAiBpE;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAuBjE,+EAA+E;IAC/E,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE;IAgBzC,uFAAuF;IACvF,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;CAGd"}

package/dist/manifest-cache.js

@@ -0,0 +1,150 @@
+/**
+ * Manifest cache — persistent, hash-keyed store for compiled DQLManifest artifacts.
+ *
+ * Lives at `.dql/cache/manifest.sqlite` by default. Keyed by a deterministic
+ * fingerprint over every input file that contributed to the build (all `.dql`,
+ * `.dqlnb`, semantic YAML, and the dbt `manifest.json`). A cache hit returns
+ * the previous manifest JSON untouched; a miss signals the builder to do a
+ * full rebuild and `put()` the result.
+ *
+ * File-level hashes are stored separately so callers (e.g. `dql sync dbt`,
+ * incremental rebuilders) can detect *which* files changed since last build
+ * without reading every file's contents.
+ */
+import Database from 'better-sqlite3';
+import { createHash } from 'node:crypto';
+import { readFileSync, statSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * SQLite-backed cache for compiled manifests.
+ *
+ * Schema
+ * - `manifest_entries`: one row per fingerprint, holds the serialized manifest
+ * - `file_hashes`: the last-seen content hash for each tracked file, used to
+ *   compute a dirty set on cold paths
+ */
+export class ManifestCache {
+    db;
+    constructor(options) {
+        ensureDirExists(options.path);
+        this.db = new Database(options.path);
+        this.db.pragma('journal_mode = WAL');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS manifest_entries (
+        fingerprint  TEXT PRIMARY KEY,
+        payload      TEXT NOT NULL,
+        built_at     TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS file_hashes (
+        path          TEXT PRIMARY KEY,
+        content_hash  TEXT NOT NULL,
+        updated_at    TEXT NOT NULL
+      );
+    `);
+    }
+    /**
+     * Compute a stable fingerprint over a set of tracked files. The caller
+     * should include every file whose contents could change the manifest
+     * (all `.dql`, `.dqlnb`, semantic YAML, and dbt `manifest.json`).
+     *
+     * Fingerprint = sha256 of `path\0hash\n` joined for a lexicographically
+     * sorted file list. Missing content hashes are filled in from disk.
+     */
+    fingerprint(files) {
+        const resolved = files
+            .map((f) => ({ path: f.path, contentHash: f.contentHash ?? hashFile(f.path) }))
+            .sort((a, b) => a.path.localeCompare(b.path));
+        const hash = createHash('sha256');
+        for (const f of resolved) {
+            hash.update(f.path);
+            hash.update('\0');
+            hash.update(f.contentHash);
+            hash.update('\n');
+        }
+        return hash.digest('hex');
+    }
+    /**
+     * Look up a previously-cached manifest by fingerprint. On miss, returns the
+     * set of file paths whose current content hash differs from the last stored
+     * hash — callers can use this to rebuild only affected subgraphs.
+     */
+    lookup(fingerprint, files) {
+        const row = this.db
+            .prepare('SELECT payload, built_at FROM manifest_entries WHERE fingerprint = ?')
+            .get(fingerprint);
+        if (row) {
+            return {
+                hit: true,
+                value: JSON.parse(row.payload),
+                fingerprint,
+                builtAt: row.built_at,
+            };
+        }
+        return { hit: false, changedFiles: this.diffFiles(files) };
+    }
+    /**
+     * Persist a newly-built manifest under `fingerprint`, and record the per-file
+     * content hashes so the next miss can report a precise dirty set.
+     */
+    put(fingerprint, value, files) {
+        const now = new Date().toISOString();
+        const payload = JSON.stringify(value);
+        const resolved = files.map((f) => ({
+            path: f.path,
+            content_hash: f.contentHash ?? hashFile(f.path),
+        }));
+        const writeEntry = this.db.prepare('INSERT OR REPLACE INTO manifest_entries (fingerprint, payload, built_at) VALUES (?, ?, ?)');
+        const writeFile = this.db.prepare('INSERT OR REPLACE INTO file_hashes (path, content_hash, updated_at) VALUES (?, ?, ?)');
+        const tx = this.db.transaction(() => {
+            writeEntry.run(fingerprint, payload, now);
+            for (const f of resolved)
+                writeFile.run(f.path, f.content_hash, now);
+        });
+        tx();
+    }
+    /** Return the files whose current content hash differs from the stored one. */
+    diffFiles(files) {
+        if (files.length === 0)
+            return [];
+        const stored = new Map();
+        const rows = this.db.prepare('SELECT path, content_hash FROM file_hashes').all();
+        for (const r of rows)
+            stored.set(r.path, r.content_hash);
+        const changed = [];
+        for (const f of files) {
+            const current = f.contentHash ?? hashFile(f.path);
+            const prior = stored.get(f.path);
+            if (prior !== current)
+                changed.push(f.path);
+        }
+        return changed;
+    }
+    /** Clear all cached manifests and file hashes. Useful for `dql compile --no-cache`. */
+    clear() {
+        this.db.exec('DELETE FROM manifest_entries; DELETE FROM file_hashes;');
+    }
+    close() {
+        this.db.close();
+    }
+}
+/** Compute sha256 of a file's contents. Returns a sentinel if the file is missing. */
+function hashFile(path) {
+    try {
+        // stat first so we can short-circuit on zero-byte files without reading
+        statSync(path);
+        return createHash('sha256').update(readFileSync(path)).digest('hex');
+    }
+    catch {
+        return 'missing';
+    }
+}
+function ensureDirExists(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+//# sourceMappingURL=manifest-cache.js.map

package/dist/manifest-cache.js.map

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

package/dist/manifest-cache.test.d.ts

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

package/dist/manifest-cache.test.d.ts.map

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

package/dist/manifest-cache.test.js

@@ -0,0 +1,95 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ManifestCache } from './manifest-cache.js';
+describe('ManifestCache', () => {
+    let tmpDir;
+    let dbPath;
+    let cache;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'dql-cache-'));
+        dbPath = join(tmpDir, 'cache', 'manifest.sqlite');
+        cache = new ManifestCache({ path: dbPath });
+    });
+    afterEach(() => {
+        cache.close();
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    function writeFile(name, content) {
+        const p = join(tmpDir, name);
+        writeFileSync(p, content, 'utf-8');
+        return p;
+    }
+    it('creates the SQLite file on first use', () => {
+        // Constructor already ran — if file is missing, lookup would throw.
+        const lookup = cache.lookup('nope', []);
+        expect(lookup.hit).toBe(false);
+    });
+    it('miss on empty cache returns no changed files when none tracked', () => {
+        const result = cache.lookup('abc', []);
+        expect(result).toEqual({ hit: false, changedFiles: [] });
+    });
+    it('roundtrips a manifest payload under its fingerprint', () => {
+        const a = writeFile('a.dql', 'block a {}');
+        const b = writeFile('b.dql', 'block b {}');
+        const files = [{ path: a }, { path: b }];
+        const fp = cache.fingerprint(files);
+        const manifest = { project: 'demo', blocks: { a: {}, b: {} } };
+        cache.put(fp, manifest, files);
+        const result = cache.lookup(fp, files);
+        expect(result.hit).toBe(true);
+        if (result.hit) {
+            expect(result.value).toEqual(manifest);
+            expect(result.fingerprint).toBe(fp);
+            expect(result.builtAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        }
+    });
+    it('produces a different fingerprint when a file changes', () => {
+        const a = writeFile('a.dql', 'v1');
+        const fp1 = cache.fingerprint([{ path: a }]);
+        writeFileSync(a, 'v2', 'utf-8');
+        const fp2 = cache.fingerprint([{ path: a }]);
+        expect(fp1).not.toBe(fp2);
+    });
+    it('fingerprint is stable regardless of input file order', () => {
+        const a = writeFile('a.dql', 'aaa');
+        const b = writeFile('b.dql', 'bbb');
+        const fp1 = cache.fingerprint([{ path: a }, { path: b }]);
+        const fp2 = cache.fingerprint([{ path: b }, { path: a }]);
+        expect(fp1).toBe(fp2);
+    });
+    it('diffFiles reports which specific files changed since last put', () => {
+        const a = writeFile('a.dql', 'v1');
+        const b = writeFile('b.dql', 'v1');
+        const files = [{ path: a }, { path: b }];
+        cache.put(cache.fingerprint(files), { any: true }, files);
+        writeFileSync(b, 'v2-changed', 'utf-8');
+        const changed = cache.diffFiles(files);
+        expect(changed).toEqual([b]);
+    });
+    it('missing files hash to a sentinel so their absence is cacheable', () => {
+        const ghost = join(tmpDir, 'does-not-exist.dql');
+        const fp1 = cache.fingerprint([{ path: ghost }]);
+        const fp2 = cache.fingerprint([{ path: ghost }]);
+        expect(fp1).toBe(fp2);
+    });
+    it('clear() removes all entries and file hashes', () => {
+        const a = writeFile('a.dql', 'x');
+        const files = [{ path: a }];
+        const fp = cache.fingerprint(files);
+        cache.put(fp, { ok: 1 }, files);
+        cache.clear();
+        const result = cache.lookup(fp, files);
+        expect(result.hit).toBe(false);
+        expect(cache.diffFiles(files)).toEqual([a]); // a is now "new" again
+    });
+    it('accepts a caller-supplied content hash and does not read the file', () => {
+        const ghost = join(tmpDir, 'never-created.dql');
+        const fp = cache.fingerprint([{ path: ghost, contentHash: 'deadbeef' }]);
+        // Same precomputed hash → same fingerprint, even though the file doesn't exist
+        const fp2 = cache.fingerprint([{ path: ghost, contentHash: 'deadbeef' }]);
+        expect(fp).toBe(fp2);
+    });
+});
+//# sourceMappingURL=manifest-cache.test.js.map

package/dist/manifest-cache.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-project",
-  "version": "0.8.16",
+  "version": "0.10.0",
   "description": "DQL project and block registry primitives: block metadata, versions, sync, and storage adapters",
   "license": "Apache-2.0",
   "type": "module",
@@ -12,6 +12,12 @@
       "import": "./dist/index.js"
     }
   },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -b",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepublishOnly": "pnpm run build"
+  },
   "files": [
     "dist"
   ],
@@ -24,8 +30,8 @@
     "access": "public"
   },
   "dependencies": {
-    "better-sqlite3": "^11.7.0",
-    "@duckcodeailabs/dql-core": "0.8.16"
+    "@duckcodeailabs/dql-core": "workspace:*",
+    "better-sqlite3": "^11.7.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
@@ -34,10 +40,5 @@
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -b",
-    "test": "vitest run --passWithNoTests",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo"
   }
-}
+}

package/LICENSE

@@ -1,123 +0,0 @@
-Apache License
-Version 2.0, January 2004
-http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-"License" shall mean the terms and conditions for use, reproduction, and
-distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright
-owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities
-that control, are controlled by, or are under common control with that entity.
-For the purposes of this definition, "control" means (i) the power, direct or
-indirect, to cause the direction or management of such entity, whether by
-contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising
-permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications, including
-but not limited to software source code, documentation source, and configuration
-files.
-
-"Object" form shall mean any form resulting from mechanical transformation or
-translation of a Source form, including but not limited to compiled object code,
-generated documentation, and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form, made
-available under the License, as indicated by a copyright notice that is included
-in or attached to the work.
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that
-is based on (or derived from) the Work and for which the editorial revisions,
-annotations, elaborations, or other modifications represent, as a whole, an
-original work of authorship.
-
-"Contribution" shall mean any work of authorship, including the original version
-of the Work and any modifications or additions to that Work or Derivative Works
-thereof, that is intentionally submitted to Licensor for inclusion in the Work
-by the copyright owner or by an individual or Legal Entity authorized to submit
-on behalf of the copyright owner.
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
-of whom a Contribution has been received by Licensor and subsequently
-incorporated within the Work.
-
-2. Grant of Copyright License.
-
-Subject to the terms and conditions of this License, each Contributor hereby
-grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
-irrevocable copyright license to reproduce, prepare Derivative Works of,
-publicly display, publicly perform, sublicense, and distribute the Work and such
-Derivative Works in Source or Object form.
-
-3. Grant of Patent License.
-
-Subject to the terms and conditions of this License, each Contributor hereby
-grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
-irrevocable patent license to make, have made, use, offer to sell, sell, import,
-and otherwise transfer the Work.
-
-4. Redistribution.
-
-You may reproduce and distribute copies of the Work or Derivative Works thereof
-in any medium, with or without modifications, and in Source or Object form,
-provided that You meet the following conditions:
-
-(a) You must give any other recipients of the Work or Derivative Works a copy of
-this License; and
-
-(b) You must cause any modified files to carry prominent notices stating that
-You changed the files; and
-
-(c) You must retain, in the Source form of any Derivative Works that You
-distribute, all copyright, patent, trademark, and attribution notices from the
-Source form of the Work, excluding those notices that do not pertain to any part
-of the Derivative Works; and
-
-(d) If the Work includes a "NOTICE" text file as part of its distribution, then
-any Derivative Works that You distribute must include a readable copy of the
-attribution notices contained within such NOTICE file, excluding those notices
-that do not pertain to any part of the Derivative Works.
-
-5. Submission of Contributions.
-
-Unless You explicitly state otherwise, any Contribution intentionally submitted
-for inclusion in the Work by You to the Licensor shall be under the terms and
-conditions of this License, without any additional terms or conditions.
-
-6. Trademarks.
-
-This License does not grant permission to use the trade names, trademarks,
-service marks, or product names of the Licensor, except as required for
-reasonable and customary use in describing the origin of the Work.
-
-7. Disclaimer of Warranty.
-
-Unless required by applicable law or agreed to in writing, Licensor provides the
-Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
-express or implied, including, without limitation, any warranties or conditions
-of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
-PURPOSE.
-
-8. Limitation of Liability.
-
-In no event and under no legal theory, whether in tort (including negligence),
-contract, or otherwise, unless required by applicable law, shall any Contributor
-be liable to You for damages, including any direct, indirect, special,
-incidental, or consequential damages of any character arising as a result of this
-License or out of the use or inability to use the Work.
-
-9. Accepting Warranty or Additional Liability.
-
-While redistributing the Work or Derivative Works thereof, You may choose to
-offer, and charge a fee for, acceptance of support, warranty, indemnity, or
-other liability obligations and/or rights consistent with this License.
-
-END OF TERMS AND CONDITIONS