sealed-lattice 0.0.9 → 0.0.10

package/README.md

@@ -1,102 +1,7 @@
-# sealed-lattice
+# Sealed-lattice public package
 
-[![npm version](https://img.shields.io/npm/v/sealed-lattice?color=5FA04E)](https://www.npmjs.com/package/sealed-lattice)
-[![npm downloads](https://img.shields.io/npm/dm/sealed-lattice?color=5FA04E)](https://www.npmjs.com/package/sealed-lattice)
+This package is the only published npm surface in the workspace.
 
----
-
-[![CI](https://img.shields.io/github/actions/workflow/status/Tenemo/sealed-lattice/ci.yml?branch=master&label=passing%20tests&color=5FA04E)](https://github.com/Tenemo/sealed-lattice/actions/workflows/ci.yml)
-[![Tests coverage](https://img.shields.io/endpoint?url=https://tenemo.github.io/sealed-lattice/coverage-badge.json)](https://tenemo.github.io/sealed-lattice/coverage-summary.json)
-[![Documentation build](https://img.shields.io/github/actions/workflow/status/Tenemo/sealed-lattice/pages.yml?branch=master&label=docs&color=5FA04E)](https://github.com/Tenemo/sealed-lattice/actions/workflows/pages.yml)
-
----
-
-[![Node version](https://img.shields.io/badge/node-%E2%89%A524.14.1-5FA04E?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![License](https://img.shields.io/github/license/Tenemo/sealed-lattice?color=5FA04E)](LICENSE)
-
----
-
-`sealed-lattice` is a browser-native TypeScript package for post-quantum voting research prototypes.
-
-The current implementation ships:
-
-- a real `sha256Hex` helper on the safe root package
-- a typed `UnsupportedRuntimeError` for missing Web Crypto support
-- a hardened repo, docs, testing, and publish workflow around that narrow surface
-- a deliberately narrow public surface while the lattice-native architecture is still being proven
-
-This repository is a hardened research prototype. It is not audited production voting software.
-
-## Release status
-
-This repository currently tracks the initial public `sealed-lattice` surface.
-
-The public surface is intentionally narrow while the repo, CI, docs, tests, coverage, and packaging experience are stabilized. Lattice cryptography, threshold flows, transport payloads, proofs, protocol types, and any future subpath structure are still being designed and are not frozen yet.
-
-## Installation
-
-```bash
-pnpm add sealed-lattice
-```
-
-## Runtime requirements
-
-- Use ESM imports such as `import { sha256Hex } from 'sealed-lattice'`. The published package does not expose CommonJS `require()` entry points.
-- Browsers need `globalThis.crypto.subtle.digest` and `TextEncoder`.
-- CI validates Chromium, Firefox, and WebKit on desktop, plus Chromium and WebKit in mobile emulation.
-- Node requires version `24.14.1` or newer with `globalThis.crypto`.
-
-## Browser support
-
-- Use modern browsers that expose `globalThis.crypto.subtle.digest` and `TextEncoder`.
-- Install local browser runtimes with `pnpm exec playwright install chromium firefox webkit`.
-- Validate the current browser matrix with `pnpm run verify:browser-compat`.
-- The local compatibility probe runs the targets supported on your current platform. CI runs the full desktop and mobile-emulation matrix on macOS.
-
-## Safe quickstart
-
-```typescript
-import { sha256Hex } from "sealed-lattice";
-
-const digest = await sha256Hex("sealed-lattice");
-
-console.log(digest);
-```
-
-The root package currently exposes only `sha256Hex` and `UnsupportedRuntimeError`.
-
-## Public package boundary
-
-- `sealed-lattice`
-
-No additional public subpaths are promised yet. Future capability areas such as runtime helpers, serialization, transport, threshold coordination, proofs, and protocol types remain internal design space until the post-quantum flow and misuse-resistant contracts are stable.
-
-## Documentation
-
-- Hosted documentation site: [tenemo.github.io/sealed-lattice](https://tenemo.github.io/sealed-lattice/)
-- Get started: [tenemo.github.io/sealed-lattice/guides/getting-started](https://tenemo.github.io/sealed-lattice/guides/getting-started/)
-- Browser and worker usage: [tenemo.github.io/sealed-lattice/guides/browser-and-worker-usage](https://tenemo.github.io/sealed-lattice/guides/browser-and-worker-usage/)
-- Runtime and compatibility: [tenemo.github.io/sealed-lattice/guides/runtime-and-compatibility](https://tenemo.github.io/sealed-lattice/guides/runtime-and-compatibility/)
-- Security and non-goals: [tenemo.github.io/sealed-lattice/guides/security-and-non-goals](https://tenemo.github.io/sealed-lattice/guides/security-and-non-goals/)
-- Protocol spec: [tenemo.github.io/sealed-lattice/spec](https://tenemo.github.io/sealed-lattice/spec/)
-- API reference: [tenemo.github.io/sealed-lattice/api](https://tenemo.github.io/sealed-lattice/api/)
-
-## Development
-
-```bash
-pnpm install
-pnpm run lint
-pnpm run tsc
-pnpm exec playwright install chromium firefox webkit
-pnpm run test
-pnpm run verify:browser-compat
-pnpm run verify:docs
-pnpm run docs:build:site
-pnpm run smoke:pack
-pnpm run smoke:pack:npm
-pnpm run build
-```
-
-## License
-
-This project is licensed under MPL-2.0. See [LICENSE](LICENSE).
+The current public runtime facade is intentionally empty. The package exists so
+packaging, documentation, smoke checks, and release workflow can stabilize
+before broader protocol-facing APIs are introduced.

package/dist/index.d.ts

@@ -1 +1 @@
-export { UnsupportedRuntimeError, sha256Hex } from './core/index.js';
+export {};

package/dist/index.js

@@ -1 +1,2 @@
-export { UnsupportedRuntimeError, sha256Hex } from './core/index.js';
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,112 +1,44 @@
 {
-    "name": "sealed-lattice",
-    "version": "0.0.9",
-    "description": "A browser-native TypeScript package for sealed-lattice research prototypes, currently shipping a narrow SHA-256 helper while the post-quantum architecture remains intentionally unfrozen.",
-    "author": "Piotr Piech <piotr@piech.dev>",
-    "license": "MPL-2.0",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "imports": {
-        "#root": "./src/index.ts",
-        "#core": "./src/core/index.ts"
-    },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/Tenemo/sealed-lattice.git"
-    },
-    "bugs": {
-        "url": "https://github.com/Tenemo/sealed-lattice/issues"
-    },
-    "homepage": "https://tenemo.github.io/sealed-lattice/",
-    "packageManager": "pnpm@10.33.0",
-    "scripts": {
-        "lint": "eslint . -c eslint.config.js",
-        "eslint:fix": "eslint . --fix -c eslint.config.js",
-        "check": "pnpm run lint && pnpm run tsc && knip && tsx ./tools/ci/verify-vectors.ts",
-        "tsc": "tsc",
-        "test:node": "vitest --project node --run",
-        "test:browser": "vitest --project browser-desktop --project browser-mobile --run",
-        "test": "pnpm run test:node && pnpm run test:browser",
-        "test:watch": "vitest --project node --watch",
-        "coverage:node": "vitest --project node --run --coverage",
-        "coverage:badge": "pnpm run coverage:node && tsx ./tools/generate-coverage-badge.ts",
-        "smoke:pack": "tsx ./tools/ci/verify-packed-package.ts",
-        "smoke:pack:npm": "tsx ./tools/ci/verify-packed-package.ts --package-manager npm",
-        "check:node": "pnpm run check && pnpm run test:node",
-        "prebuild": "pnpm run check && pnpm run test",
-        "build:dist": "pnpm exec del-cli dist && tsc --project tsconfig.build.json && tsx ./tools/build/rewrite-dist-relative-imports.ts",
-        "build:ci": "pnpm run check:node && pnpm run build:dist",
-        "build": "pnpm run build:dist",
-        "vectors:core": "tsx ./tools/generate-core-vectors.ts",
-        "verify:browser-compat": "tsx ./tools/ci/verify-browser-compat.ts",
-        "docs:api": "pnpm exec del-cli docs/src/content/docs/api/reference && tsx ./node_modules/typedoc/bin/typedoc --options typedoc.config.mjs && tsx ./typedoc/postprocess-site-docs.ts",
-        "docs:dev": "pnpm run docs:api && astro dev --root docs",
-        "docs:build:site": "pnpm run docs:api && pnpm exec del-cli docs/dist && astro build --root docs --silent",
-        "docs:preview": "pnpm run docs:build:site && astro preview --root docs",
-        "verify:docs": "pnpm run docs:api && tsx ./typedoc/verify-docs.ts",
-        "bench:micro": "tsx ./tools/benchmarks/microbench.ts",
-        "prepare": "husky"
-    },
-    "devDependencies": {
-        "@astrojs/mdx": "^5.0.3",
-        "@astrojs/starlight": "^0.38.3",
-        "@eslint/eslintrc": "^3.3.5",
-        "@eslint/js": "^10.0.1",
-        "@fontsource/ibm-plex-sans": "^5.2.8",
-        "@fontsource/jetbrains-mono": "^5.2.8",
-        "@types/node": "^25.6.0",
-        "@typescript-eslint/eslint-plugin": "^8.58.2",
-        "@typescript-eslint/parser": "^8.58.2",
-        "@vitest/browser-playwright": "^4.1.4",
-        "@vitest/coverage-v8": "^4.1.4",
-        "astro": "^6.1.7",
-        "del-cli": "^7.0.0",
-        "eslint": "^10.2.0",
-        "eslint-config-prettier": "^10.1.8",
-        "eslint-plugin-import-x": "^4.16.2",
-        "eslint-plugin-only-error": "^1.0.2",
-        "eslint-plugin-prettier": "^5.5.5",
-        "globals": "^17.5.0",
-        "husky": "^9.1.7",
-        "knip": "^6.4.1",
-        "playwright": "^1.59.1",
-        "prettier": "^3.8.3",
-        "tsx": "^4.21.0",
-        "typedoc": "^0.28.19",
-        "typedoc-plugin-markdown": "^4.11.0",
-        "typescript": "^6.0.2",
-        "vite": "^8.0.8",
-        "vitest": "^4.1.4"
-    },
-    "engines": {
-        "node": ">=24.14.1"
-    },
-    "pnpm": {
-        "onlyBuiltDependencies": [
-            "esbuild",
-            "unrs-resolver"
-        ]
-    },
-    "type": "module",
-    "keywords": [
-        "cryptography",
-        "security",
-        "post-quantum",
-        "lattice",
-        "threshold-encryption",
-        "research-prototype",
-        "webcrypto",
-        "typescript-cryptography",
-        "data-protection",
-        "privacy"
-    ]
+  "name": "sealed-lattice",
+  "version": "0.0.10",
+  "description": "Published npm facade for the sealed-lattice library.",
+  "author": "Piotr Piech <piotr@piech.dev>",
+  "license": "MPL-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tenemo/sealed-lattice.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Tenemo/sealed-lattice/issues"
+  },
+  "homepage": "https://tenemo.github.io/sealed-lattice/",
+  "engines": {
+    "node": ">=24.14.1"
+  },
+  "scripts": {
+    "check": "tsc --project tsconfig.json --pretty false --noEmit",
+    "build": "pnpm exec del-cli dist tsconfig.tsbuildinfo && tsc --project tsconfig.json"
+  },
+  "keywords": [
+    "cryptography",
+    "security",
+    "post-quantum",
+    "lattice",
+    "threshold-encryption",
+    "voting"
+  ]
 }

package/dist/core/bytes.d.ts

@@ -1,2 +0,0 @@
-export declare const normalizeInputToBytes: (input: string | Uint8Array) => Uint8Array<ArrayBuffer>;
-export declare const bytesToHex: (bytes: Uint8Array) => string;

package/dist/core/bytes.js

@@ -1,8 +0,0 @@
-const textEncoder = new TextEncoder();
-export const normalizeInputToBytes = (input) => {
-    if (typeof input === 'string') {
-        return Uint8Array.from(textEncoder.encode(input));
-    }
-    return Uint8Array.from(input);
-};
-export const bytesToHex = (bytes) => Array.from(bytes, (value) => value.toString(16).padStart(2, '0')).join('');

package/dist/core/crypto.d.ts

@@ -1,10 +0,0 @@
-type SupportedCrypto = Crypto & {
-    subtle: SubtleCrypto;
-};
-export declare const getWebCrypto: () => SupportedCrypto;
-/**
- * Returns the lowercase hexadecimal SHA-256 digest of the provided text or
- * byte input.
- */
-export declare const sha256Hex: (input: string | Uint8Array) => Promise<string>;
-export {};

package/dist/core/crypto.js

@@ -1,18 +0,0 @@
-import { bytesToHex, normalizeInputToBytes } from './bytes.js';
-import { UnsupportedRuntimeError } from './errors.js';
-const hasDigest = (value) => typeof value?.subtle?.digest === 'function';
-export const getWebCrypto = () => {
-    const cryptoApi = globalThis.crypto;
-    if (!hasDigest(cryptoApi)) {
-        throw new UnsupportedRuntimeError();
-    }
-    return cryptoApi;
-};
-/**
- * Returns the lowercase hexadecimal SHA-256 digest of the provided text or
- * byte input.
- */
-export const sha256Hex = async (input) => {
-    const digest = await getWebCrypto().subtle.digest('SHA-256', normalizeInputToBytes(input));
-    return bytesToHex(new Uint8Array(digest));
-};

package/dist/core/errors.d.ts

@@ -1,7 +0,0 @@
-/**
- * Error thrown when the current runtime does not provide the Web Crypto API
- * features required by the public package surface.
- */
-export declare class UnsupportedRuntimeError extends Error {
-    constructor(message?: string);
-}

package/dist/core/errors.js

@@ -1,11 +0,0 @@
-/**
- * Error thrown when the current runtime does not provide the Web Crypto API
- * features required by the public package surface.
- */
-export class UnsupportedRuntimeError extends Error {
-    constructor(message = 'sealed-lattice requires globalThis.crypto.subtle.digest.') {
-        super(message);
-        this.name = new.target.name;
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}

package/dist/core/index.d.ts

@@ -1,3 +0,0 @@
-export { bytesToHex, normalizeInputToBytes } from './bytes.js';
-export { getWebCrypto, sha256Hex } from './crypto.js';
-export { UnsupportedRuntimeError } from './errors.js';

package/dist/core/index.js

@@ -1,3 +0,0 @@
-export { bytesToHex, normalizeInputToBytes } from './bytes.js';
-export { getWebCrypto, sha256Hex } from './crypto.js';
-export { UnsupportedRuntimeError } from './errors.js';