@krantho/persistence-fs 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/content-query.d.ts

@@ -0,0 +1,15 @@
+import type { ContentDocument, ContentQuery, QueryPage, QueryProjection } from '@krantho/persistence';
+/** A document read for a query: `full` needs the rendered HTML and sections, the rest do not */
+export type QueriedDocument = Omit<ContentDocument, 'html' | 'sections'> & Partial<Pick<ContentDocument, 'html' | 'sections'>>;
+/** Where a query reads the files of the adapter's collections */
+export interface QuerySource {
+    /** The collections the adapter was given a directory for */
+    collections(): string[];
+    /** The slugs of a collection's files */
+    slugs(collection: string): Promise<string[]>;
+    /** One file as a document; rendered (HTML and sections) only when `render` is set */
+    read(collection: string, slug: string, render: boolean): Promise<QueriedDocument>;
+}
+/** Run a content query over the files of the adapter's collections */
+export declare function runContentQuery<P extends QueryProjection>(source: QuerySource, spec: ContentQuery<P>): Promise<QueryPage<P>>;
+//# sourceMappingURL=content-query.d.ts.map

package/dist/content-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-query.d.ts","sourceRoot":"","sources":["../src/content-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAKZ,SAAS,EACT,eAAe,EAChB,MAAM,sBAAsB,CAAA;AAO7B,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAA;AAErD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,WAAW,IAAI,MAAM,EAAE,CAAA;IACvB,wCAAwC;IACxC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,qFAAqF;IACrF,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAClF;AAuGD,sEAAsE;AACtE,wBAAsB,eAAe,CAAC,CAAC,SAAS,eAAe,EAC7D,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAiBvB"}

package/dist/content-query.js

@@ -0,0 +1,122 @@
+import { isDirectSortColumn, isSafeSortField } from '@krantho/persistence';
+/** Characters of a snippet before the match, and from the match on */
+const SNIPPET_BEFORE = 80;
+const SNIPPET_LENGTH = 200;
+/** The text of a document each match target searches */
+function targetText(doc, target) {
+    if (target === 'slug')
+        return doc.meta.slug;
+    if (target === 'fields')
+        return JSON.stringify(doc.fields);
+    return doc.body;
+}
+/**
+ * The snippet of the first match: from the body when it matches there, else from the
+ * fields' JSON. Positions count characters (code points), as `substr` does in SQL, and
+ * the position found in the folded text applies to the original.
+ */
+function snippetOf(doc, targets, needle) {
+    for (const target of ['body', 'fields']) {
+        if (!targets.includes(target))
+            continue;
+        const text = targetText(doc, target);
+        const index = text.toLowerCase().indexOf(needle);
+        if (index < 0)
+            continue;
+        const before = Array.from(text.slice(0, index)).length;
+        const start = Math.max(0, before - SNIPPET_BEFORE);
+        return Array.from(text)
+            .slice(start, start + SNIPPET_LENGTH)
+            .join('')
+            .replace(/\s+/g, ' ');
+    }
+    return undefined;
+}
+/** Whether any target contains the folded needle */
+function matches(doc, targets, needle) {
+    return targets.some((target) => targetText(doc, target).toLowerCase().includes(needle));
+}
+/** The value a sort field orders a document by; a document without it sorts first */
+function sortValue(doc, field) {
+    const direct = {
+        slug: doc.meta.slug,
+        status: doc.meta.status,
+        locale: doc.meta.locale,
+        created_at: doc.meta.createdAt,
+    };
+    if (isDirectSortColumn(field))
+        return direct[field];
+    const value = isSafeSortField(field) ? doc.fields[field] : undefined;
+    if (typeof value === 'number' || typeof value === 'string')
+        return value;
+    return value === undefined || value === null ? null : String(value);
+}
+/** Order two values as SQL does: nulls first, numbers numerically, text by code unit */
+function compareValues(a, b) {
+    if (a === b)
+        return 0;
+    if (a === null)
+        return -1;
+    if (b === null)
+        return 1;
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    const left = String(a);
+    const right = String(b);
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Order two documents: the requested sort, then `collection, slug, locale` so paging is stable */
+function compareDocuments(sort) {
+    const [field, direction] = sort ? sort.split(':') : [];
+    const sign = direction === 'desc' ? -1 : 1;
+    return (a, b) => {
+        const ordered = field ? sign * compareValues(sortValue(a, field), sortValue(b, field)) : 0;
+        return (ordered ||
+            compareValues(a.meta.collection, b.meta.collection) ||
+            compareValues(a.meta.slug, b.meta.slug) ||
+            compareValues(a.meta.locale, b.meta.locale));
+    };
+}
+/** The documents of the query's collections that its state, status and locale admit */
+async function candidates(source, spec) {
+    const render = spec.projection === 'full';
+    const found = [];
+    for (const collection of spec.collections ?? source.collections()) {
+        for (const slug of await source.slugs(collection)) {
+            const doc = await source.read(collection, slug, render);
+            if (spec.locale && doc.meta.locale !== spec.locale)
+                continue;
+            // A file is one version and is live when published: `current` and `published` read the same file
+            if (spec.state === 'published' && doc.meta.status !== 'published')
+                continue;
+            if (spec.state === 'current' && spec.status && doc.meta.status !== spec.status)
+                continue;
+            found.push(doc);
+        }
+    }
+    return found;
+}
+function projected(projection, doc) {
+    if (projection === 'meta')
+        return doc.meta;
+    if (projection === 'summary')
+        return { meta: doc.meta, fields: doc.fields, metadata: doc.metadata };
+    return doc;
+}
+/** Run a content query over the files of the adapter's collections */
+export async function runContentQuery(source, spec) {
+    const needle = spec.match?.text.toLowerCase() ?? '';
+    const matched = (await candidates(source, spec)).filter((doc) => !spec.match || matches(doc, spec.match.in, needle));
+    matched.sort(compareDocuments(spec.sort));
+    const start = spec.offset ?? 0;
+    const end = spec.limit === undefined ? undefined : start + spec.limit;
+    const page = matched.slice(start, end);
+    const hasMore = end !== undefined && matched.length > end;
+    const items = page.map((doc) => {
+        const item = projected(spec.projection, doc);
+        const snippet = spec.match ? snippetOf(doc, spec.match.in, needle) : undefined;
+        return snippet === undefined ? item : { ...item, snippet };
+    });
+    return { items, hasMore };
+}
+//# sourceMappingURL=content-query.js.map

package/dist/content-query.js.map

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

package/dist/filesystem.d.ts

@@ -0,0 +1,49 @@
+import { type ContentMetadata, type IContentLoader } from '@krantho/core';
+import type { ContentDocument, ContentQuery, IPersistenceAdapter, PersistenceConfig, QueryPage, QueryProjection, WriteContentData } from '@krantho/persistence';
+/** Construction options for {@link FileSystemAdapter} */
+export interface FileSystemAdapterOptions extends Partial<PersistenceConfig> {
+    /**
+     * Each collection's directory, by collection name. A collection without one
+     * keeps its files in `contentPath`.
+     */
+    directories?: ReadonlyMap<string, string> | undefined;
+    /**
+     * Locale of a markdown file whose frontmatter declares none: the site's
+     * default locale, `site.defaultLocale` in the krantho configuration.
+     */
+    defaultLocale: string;
+    /**
+     * Status for a markdown file whose frontmatter declares none.
+     *
+     * A deployment sets this through `content.defaultStatus.filesystem`.
+     */
+    defaultStatus?: string | undefined;
+}
+export declare class FileSystemAdapter implements IPersistenceAdapter, IContentLoader {
+    private readonly contentPath;
+    private readonly directories;
+    private readonly defaultStatus;
+    private readonly defaultLocale;
+    constructor(config: FileSystemAdapterOptions);
+    exists(slug: string): Promise<boolean>;
+    read(slug: string): Promise<string>;
+    getMetadata(slug: string): Promise<Pick<ContentMetadata, 'size' | 'lastModified'>>;
+    listSlugs(): Promise<string[]>;
+    /** The document of a collection's file, whatever locale is named: a file holds one document */
+    getContent(collection: string, slug: string, _locale?: string | undefined): Promise<ContentDocument | null>;
+    /** A file is live when its status (frontmatter, or the default) is published */
+    getPublished(collection: string, slug: string, locale?: string | undefined): Promise<ContentDocument | null>;
+    /** The one read behind every list, over the files of the collections the adapter has a directory for */
+    query<P extends QueryProjection>(spec: ContentQuery<P>): Promise<QueryPage<P>>;
+    writeContent(data: WriteContentData): Promise<void>;
+    /** Removes the collection's file, whatever locale is named: a file holds one document */
+    deleteContent(collection: string, slug: string, _locale?: string | undefined): Promise<void>;
+    /** A collection's file, parsed and rendered as the content import renders it */
+    private readDocument;
+    /** A collection's file, parsed; rendered (HTML and sections) only when `render` is set */
+    private readFile;
+    private directoryOf;
+    private filePath;
+    private resolveContentPath;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EAGpB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAEV,eAAe,EACf,YAAY,EAGZ,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAU7B,yDAAyD;AACzD,MAAM,WAAW,wBAAyB,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IAC1E;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IACrD;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAyCD,qBAAa,iBAAkB,YAAW,mBAAmB,EAAE,cAAc;IAC3E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAE1B,MAAM,EAAE,wBAAwB;IAQtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC;IAQlF,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpC,+FAA+F;IACzF,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQlC,gFAAgF;IAC1E,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKlC,wGAAwG;IAClG,KAAK,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAW9E,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzD,yFAAyF;IACnF,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAAC,IAAI,CAAC;IAIhB,gFAAgF;YAClE,YAAY;IAI1B,0FAA0F;YAC5E,QAAQ;IA2BtB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist/filesystem.js

@@ -0,0 +1,170 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { DEFAULT_FRONTMATTER_STATUS, renderContent, splitFrontmatter, } from '@krantho/core';
+import { authoredMetadata, repositoryFrontmatter, repositoryMarkdown } from '@krantho/persistence';
+import matter from 'gray-matter';
+import { runContentQuery } from './content-query.js';
+const DEFAULT_FS_CONFIG = {
+    contentPath: 'content/pages',
+    seoPath: 'content/seo',
+};
+/** A file's publication state from its frontmatter status */
+function fileState(status) {
+    return status === 'published' || status === 'archived' ? status : 'draft';
+}
+/**
+ * A file's document metadata. A file is one version with no history: it is
+ * live when its status is published, so it can hold no changes ahead of what
+ * visitors see — a save to a published file is live at once.
+ */
+function fileMeta(collection, slug, locale, status, modified) {
+    const state = fileState(status);
+    return {
+        collection,
+        slug,
+        locale,
+        version: 1,
+        liveVersion: state === 'published' ? 1 : null,
+        status: state,
+        source: 'filesystem',
+        changedBy: null,
+        createdAt: modified.toISOString(),
+    };
+}
+/** The status a write leaves a file in: publishing publishes, a save keeps the file's status */
+function statusAfterWrite(data, previous) {
+    if (data.publication === 'publish')
+        return 'published';
+    if (data.publication === 'unpublish')
+        return 'draft';
+    if (data.publication === 'archive')
+        return 'archived';
+    return previous ?? 'draft';
+}
+export class FileSystemAdapter {
+    contentPath;
+    directories;
+    defaultStatus;
+    defaultLocale;
+    constructor(config) {
+        const merged = { ...DEFAULT_FS_CONFIG, ...config };
+        this.contentPath = merged.contentPath;
+        this.directories = config.directories ?? new Map();
+        this.defaultLocale = config.defaultLocale;
+        this.defaultStatus = config.defaultStatus ?? DEFAULT_FRONTMATTER_STATUS;
+    }
+    async exists(slug) {
+        try {
+            await fs.access(this.resolveContentPath(slug));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async read(slug) {
+        return fs.readFile(this.resolveContentPath(slug), 'utf-8');
+    }
+    async getMetadata(slug) {
+        const stat = await fs.stat(this.resolveContentPath(slug));
+        return {
+            size: stat.size,
+            lastModified: stat.mtime,
+        };
+    }
+    async listSlugs() {
+        return slugsIn(this.contentPath);
+    }
+    /** The document of a collection's file, whatever locale is named: a file holds one document */
+    async getContent(collection, slug, _locale) {
+        try {
+            return await this.readDocument(collection, slug);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** A file is live when its status (frontmatter, or the default) is published */
+    async getPublished(collection, slug, locale) {
+        const doc = await this.getContent(collection, slug, locale);
+        return doc?.meta.status === 'published' ? doc : null;
+    }
+    /** The one read behind every list, over the files of the collections the adapter has a directory for */
+    async query(spec) {
+        return runContentQuery({
+            collections: () => [...this.directories.keys()],
+            slugs: (collection) => slugsIn(this.directoryOf(collection)),
+            read: (collection, slug, render) => this.readFile(collection, slug, render),
+        }, spec);
+    }
+    async writeContent(data) {
+        const filePath = this.filePath(data.collection, data.slug);
+        const previous = await this.getContent(data.collection, data.slug);
+        // Merge content fields + the status back into YAML frontmatter for file storage
+        const content = repositoryMarkdown({
+            identity: {
+                collection: data.collection,
+                slug: data.slug,
+                locale: data.locale ?? this.defaultLocale,
+            },
+            fields: { ...data.fields, status: statusAfterWrite(data, previous?.meta.status) },
+            body: data.body,
+            metadata: data.metadata ?? {},
+            contract: data.contract ?? null,
+            defaults: data.defaults ?? [],
+        });
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    /** Removes the collection's file, whatever locale is named: a file holds one document */
+    async deleteContent(collection, slug, _locale) {
+        await fs.unlink(this.filePath(collection, slug));
+    }
+    /** A collection's file, parsed and rendered as the content import renders it */
+    async readDocument(collection, slug) {
+        return (await this.readFile(collection, slug, true));
+    }
+    /** A collection's file, parsed; rendered (HTML and sections) only when `render` is set */
+    async readFile(collection, slug, render) {
+        const filePath = this.filePath(collection, slug);
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const parsed = matter(raw);
+        const { fields, status, locale } = splitFrontmatter(parsed.data, this.defaultLocale, this.defaultStatus);
+        const stat = await fs.stat(filePath);
+        const document = {
+            meta: fileMeta(collection, slug, locale, status, stat.mtime),
+            fields,
+            ...authoredMetadata(repositoryFrontmatter(parsed.data)),
+            body: parsed.content,
+        };
+        if (!render)
+            return document;
+        // As the content import renders a file, so both providers store the same HTML; pages
+        // substitute @-notation when they render
+        const { html, sections } = await renderContent(fields, parsed.content, { atNotation: false });
+        return { ...document, html, sections };
+    }
+    directoryOf(collection) {
+        return this.directories.get(collection) ?? this.contentPath;
+    }
+    filePath(collection, slug) {
+        return path.join(this.directoryOf(collection), `${slug}.md`);
+    }
+    resolveContentPath(slug) {
+        return path.join(this.contentPath, `${slug}.md`);
+    }
+}
+/** The slugs of the markdown files in a directory; none when the directory does not exist yet */
+async function slugsIn(directory) {
+    let entries;
+    try {
+        entries = await fs.readdir(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return entries.filter((entry) => entry.endsWith('.md')).map((entry) => entry.slice(0, -3));
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { IPersistenceAdapter, PersistenceConfig } from '@krantho/persistence';
+export type { FileSystemAdapterOptions } from './filesystem.js';
+export { FileSystemAdapter } from './filesystem.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAClF,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { FileSystemAdapter } from './filesystem.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@krantho/persistence-fs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/persistence-fs"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "yaml": "^2.9.0",
+    "@krantho/core": "1.0.0",
+    "@krantho/persistence": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.