{"_id":"@caifrazier/atls-spec","name":"@caifrazier/atls-spec","dist-tags":{"rc":"1.0.0-rc.1","latest":"1.0.0-rc.1"},"versions":{"1.0.0-rc.1":{"name":"@caifrazier/atls-spec","version":"1.0.0-rc.1","description":"The Atlas archive format specification: Zod schemas, generated JSON Schemas, TypeScript types, and validators","type":"module","author":{"name":"Cai Frazier"},"license":"Apache-2.0 AND CC-BY-4.0","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./schemas/*":{"types":"./dist/schemas/*","import":"./dist/schemas/*"},"./package.json":"./package.json","./dist/*":"./dist/*"},"dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.23.0"},"devDependencies":{"@types/node":"^20.14.10","typescript":"^5.6.3","vitest":"^2.0.0"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -b && node dist/schemas/generator.js","build:schemas":"node dist/schemas/generator.js","dev":"tsc -b --watch","test":"VITEST_POOL=forks VITEST_MIN_WORKERS=1 VITEST_MAX_WORKERS=1 vitest run --pool=forks --minWorkers=1 --maxWorkers=1","lint":"eslint .","clean":"rimraf dist tsconfig.tsbuildinfo"},"_id":"@caifrazier/atls-spec@1.0.0-rc.1","_integrity":"sha512-Sra41VKDLPCMuse2Lh3AZVUA4DIHrJfaZMmNi2n/sz7XN4yL8wgKF8+BcF9SESLe8tSgkgWxT8W7y9leGOBSHQ==","_resolved":"/private/var/folders/vw/qq7ngvrs48717pvqb7n89r640000gn/T/3534948e5470cd2d7752106fd92bb3fb/caifrazier-atls-spec-1.0.0-rc.1.tgz","_from":"file:caifrazier-atls-spec-1.0.0-rc.1.tgz","_nodeVersion":"25.4.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-Sra41VKDLPCMuse2Lh3AZVUA4DIHrJfaZMmNi2n/sz7XN4yL8wgKF8+BcF9SESLe8tSgkgWxT8W7y9leGOBSHQ==","shasum":"27f947fd368eb153e3dc5ee4b7fe14bfc3ac56ef","tarball":"https://registry.npmjs.org/@caifrazier/atls-spec/-/atls-spec-1.0.0-rc.1.tgz","fileCount":178,"unpackedSize":1108417,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICSlSUaxWjcSRL7FQBCATwZZOJC1ZEWTZJoRi1YxIvhpAiB651z4VJgjlfQfRi3B3E8upqVWuQgqBiscS+2I8A/1Vw=="}]},"_npmUser":{"name":"scottfultz","email":"scott.fultz@caifrazier.com"},"directories":{},"maintainers":[{"name":"scottfultz","email":"scott.fultz@caifrazier.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atls-spec_1.0.0-rc.1_1783153798823_0.09446027062289519"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T08:29:58.612Z","1.0.0-rc.1":"2026-07-04T08:29:58.958Z","modified":"2026-07-04T08:29:59.200Z"},"maintainers":[{"name":"scottfultz","email":"scott.fultz@caifrazier.com"}],"description":"The Atlas archive format specification: Zod schemas, generated JSON Schemas, TypeScript types, and validators","author":{"name":"Cai Frazier"},"license":"Apache-2.0 AND CC-BY-4.0","readme":"# @caifrazier/atls-spec\n\nAtlas specification package for Cartographer/Atlas archives.\n\nIt provides:\n\n- TypeScript types\n- Zod schemas\n- JSON Schema generation artifacts\n\n## Package Role\n\n- Shared contract used by `@cf/cartographer` and `@caifrazier/atls-sdk`\n- Canonical schema/type source for Atlas archive structures\n\n## Exports\n\n- Core types: `src/types.ts`\n- Record split exports: `src/types/records/`\n- Normalization helpers: `src/normalize.ts` (legacy camelCase → snake_case field adapters)\n- Page-metadata flattening: `src/pageMetadataMapping.ts` (nested on-disk record → flat consumer shape)\n- Schema exports: `src/schemas/index.ts`\n\nSchemas are authored in **Zod**; the JSON Schema artifacts are generated from those Zod\ndefinitions via `src/schemas/generator.ts` (`zod-to-json-schema`) as a build step — Zod is the\nsource of truth, not the emitted `.schema.json` files.\n\n## Build\n\n```bash\npnpm --filter @caifrazier/atls-spec build\n```\n\nThis compiles TypeScript and generates JSON schema artifacts via `dist/schemas/generator.js`.\n\n## Test\n\n```bash\npnpm --filter @caifrazier/atls-spec test\n```\n\n## The Atlas Format Specification\n\nThe comprehensive, code-verified format spec lives in [`SPECIFICATION.md`](./SPECIFICATION.md)\n(the index) and [`docs/`](./docs/):\n\n- [Archive Structure](./docs/archive-structure.md) — ZIP layout, root files, dataset parts, blobs\n- [Storage & Encoding](./docs/storage-and-encoding.md) — JSONL, Zstandard, blob addressing, hashing\n- [Identity & Keys](./docs/identity-and-keys.md) — `page_id` join model, per-dataset keys\n- [Versioning & Compatibility](./docs/versioning.md) — version axes, `specLevel`, compat rules\n- [Root Metadata Files](./docs/root-files.md) — manifest / summary / capabilities / provenance fields\n- [Dataset Reference](./docs/datasets.md) — all 19 datasets, every field, presence-by-mode\n- [Schema System](./docs/schema-system.md) — Zod source, codegen, coverage gaps\n- [Reading Archives](./docs/reading-archives.md) — correct reading + the SDK caveat + workaround\n\n## Notes\n\n- For the formal contract, start at [`SPECIFICATION.md`](./SPECIFICATION.md).\n- Archived legacy docs are available at `legacy/v1/`.\n\n---\n\n_Last verified against codebase: 2026-06-04 (package version `1.0.0-rc.1`)._\n","readmeFilename":"README.md","_rev":"1-e08bc1fb8d981fd3418ddd5816849b73"}