@deskwork/core 0.15.0 → 0.17.0

package/dist/scrapbook/validation.js

@@ -0,0 +1,98 @@
+/**
+ * Scrapbook validation + classification helpers.
+ *
+ * Slug + filename validation runs at every fs entry point; a `..` or
+ * absolute path that slips through here would let a malicious request
+ * read or write outside the scrapbook tree. The route layer relies on
+ * these helpers for traversal protection.
+ */
+import { extname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Slug + path validation
+// ---------------------------------------------------------------------------
+/**
+ * A single slug segment — kebab-case lowercase. Used both for flat
+ * slugs and as the building block of hierarchical paths.
+ */
+const SLUG_SEGMENT_RE = /^[a-z0-9][a-z0-9-]*$/;
+/**
+ * A full slug path — one or more `/`-separated kebab-case segments.
+ * Accepts both legacy flat slugs ("scsi-over-wifi") and hierarchical
+ * paths ("the-outbound/characters/strivers"). No leading or trailing
+ * slash; no empty segments.
+ */
+const SLUG_RE = /^[a-z0-9][a-z0-9-]*(\/[a-z0-9][a-z0-9-]*)*$/;
+const FILENAME_RE = /^[a-zA-Z0-9._-][a-zA-Z0-9._ -]*$/;
+export function assertSlug(slug) {
+    if (!SLUG_RE.test(slug)) {
+        throw new Error(`invalid slug "${slug}" — must match ${SLUG_RE}`);
+    }
+}
+/**
+ * Split a hierarchical slug into its segments. Each segment is a
+ * standalone kebab-case identifier.
+ */
+export function slugSegments(slug) {
+    return slug.split('/');
+}
+/**
+ * True if a slug refers to a nested entry (has at least one `/`).
+ */
+export function isNestedSlug(slug) {
+    return slug.includes('/');
+}
+// `SLUG_SEGMENT_RE` is exported for callers that need to validate one
+// segment at a time (e.g. when assembling a path interactively).
+export { SLUG_SEGMENT_RE };
+export function assertFilename(name) {
+    if (!name || name === '.' || name === '..') {
+        throw new Error(`invalid filename "${name}"`);
+    }
+    if (name.includes('/') || name.includes('\\') || name.includes('\0')) {
+        throw new Error(`filename may not contain path separators: "${name}"`);
+    }
+    if (name.startsWith('.')) {
+        // Dotfiles are suspicious for a dev-only operator UI. Reject.
+        throw new Error(`filename may not start with a dot: "${name}"`);
+    }
+    if (!FILENAME_RE.test(name)) {
+        throw new Error(`filename may only contain [A-Za-z0-9._ -]: "${name}"`);
+    }
+    if (name.length > 200) {
+        throw new Error(`filename too long (> 200 chars): "${name}"`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Type classification
+// ---------------------------------------------------------------------------
+export function classify(filename) {
+    const ext = extname(filename).toLowerCase();
+    switch (ext) {
+        case '.md':
+        case '.markdown':
+            return 'md';
+        case '.json':
+        case '.jsonl':
+            return 'json';
+        case '.js':
+        case '.mjs':
+        case '.cjs':
+        case '.ts':
+        case '.tsx':
+        case '.mts':
+            return 'js';
+        case '.png':
+        case '.jpg':
+        case '.jpeg':
+        case '.gif':
+        case '.webp':
+        case '.svg':
+            return 'img';
+        case '.txt':
+        case '.log':
+            return 'txt';
+        default:
+            return 'other';
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/scrapbook/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/scrapbook/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,OAAO,GAAG,6CAA6C,CAAC;AAC9D,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,sEAAsE;AACtE,iEAAiE;AACjE,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,GAAG,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/scrapbook.d.ts

@@ -4,286 +4,52 @@
  * research, and references attached to an in-flight article. Committed
  * to git alongside the article; not baked to the public site.
  *
- * Responsibilities:
- *   - Resolve + validate slug + filename (reject `..`, absolute paths,
- *     and anything outside the article's scrapbook dir)
- *   - List + read + mutate files inside one scrapbook
- *   - Classify files by extension into the design type buckets
- *   - Format relative mtime + total size for the studio chip / viewer
+ * Responsibilities (split across sibling modules under `scrapbook/`
+ * per #202; this file is a barrel re-export so existing
+ * `import from '@deskwork/core/scrapbook'` sites stay unchanged):
+ *
+ *   - `scrapbook/types.ts`       — public types
+ *   - `scrapbook/validation.ts`  — slug + filename validation, classify
+ *   - `scrapbook/paths.ts`       — public (entry-aware + path-aware) +
+ *                                  private (slug-template) resolvers
+ *   - `scrapbook/listing.ts`     — list + count
+ *   - `scrapbook/read.ts`        — read primitives
+ *   - `scrapbook/crud-at-dir.ts` — entry-aware CRUD primitives (post-#191)
+ *   - `scrapbook/crud-slug.ts`   — INTERNAL slug-template CRUD primitives
+ *   - `scrapbook/seed.ts`        — plan-time scaffolding
+ *   - `scrapbook/format.ts`      — UI formatters
+ *
+ * Public API surface (#192 — slug-template mutators are NO LONGER
+ * exported; callers go through `scrapbookDirForEntry` + the `*AtDir`
+ * family instead):
+ *
+ *   - Types: `ScrapbookItemKind`, `ScrapbookItem`, `ScrapbookSummary`,
+ *     `ScrapbookLocation`, `SECRET_SUBDIR`
+ *   - Validation: `assertSlug`, `assertFilename`, `slugSegments`,
+ *     `isNestedSlug`, `SLUG_SEGMENT_RE`, `classify`
+ *   - Paths: `scrapbookDirAtPath`, `scrapbookDirForEntry`,
+ *     `scrapbookFilePathAtDir`
+ *   - Listing: `listScrapbook`, `listScrapbookAtDir`,
+ *     `listScrapbookForEntry`, `countScrapbook`, `countScrapbookForEntry`
+ *   - Read: `readScrapbookFile`, `readScrapbookFileAtDir`,
+ *     `readScrapbookFileForEntry`
+ *   - CRUD: `createScrapbookMarkdownAtDir`, `saveScrapbookFileAtDir`,
+ *     `renameScrapbookFileAtDir`, `deleteScrapbookFileAtDir`,
+ *     `writeScrapbookUploadAtDir`
+ *   - Seed: `seedScrapbookReadme`
+ *   - Format: `formatRelativeTime`, `formatSize`
  *
  * The API endpoints that wrap these helpers should 404 in PROD; this
  * library contains no PROD check of its own (enforcement stays at the
  * endpoint boundary).
  */
-import type { DeskworkConfig } from './config.ts';
-import type { ContentIndex } from './content-index.ts';
-/** Type buckets for scrapbook entries. */
-export type ScrapbookItemKind = 'md' | 'json' | 'js' | 'img' | 'txt' | 'other';
-export interface ScrapbookItem {
-    name: string;
-    kind: ScrapbookItemKind;
-    size: number;
-    mtime: string;
-}
-export interface ScrapbookSummary {
-    site: string;
-    /**
-     * The scrapbook's location identifier — a slug for entries tied to a
-     * calendar row, or any directory path within `contentDir` for
-     * scrapbooks that hang off purely organizational nodes (e.g. an
-     * intermediate project directory that isn't itself a calendar entry).
-     */
-    slug: string;
-    dir: string;
-    exists: boolean;
-    /** Files at the top of `scrapbook/` (public/published-side notes). */
-    items: ScrapbookItem[];
-    /**
-     * Files inside `scrapbook/secret/` — never to be published. Operators
-     * can drop research, drafts, or sensitive notes here knowing the host
-     * project's content collection patterns won't pick them up.
-     */
-    secretItems: ScrapbookItem[];
-}
-/** Well-known subdirectory name for editorially-private scrapbook items. */
-export declare const SECRET_SUBDIR = "secret";
-/**
- * A single slug segment — kebab-case lowercase. Used both for flat
- * slugs and as the building block of hierarchical paths.
- */
-declare const SLUG_SEGMENT_RE: RegExp;
-export declare function assertSlug(slug: string): void;
-/**
- * Split a hierarchical slug into its segments. Each segment is a
- * standalone kebab-case identifier.
- */
-export declare function slugSegments(slug: string): string[];
-/**
- * True if a slug refers to a nested entry (has at least one `/`).
- */
-export declare function isNestedSlug(slug: string): boolean;
-export { SLUG_SEGMENT_RE };
-export declare function assertFilename(name: string): void;
-/**
- * Resolve the scrapbook directory for (site, slug) and ensure the
- * return path stays inside the site's content directory.
- * Doesn't require the directory to exist.
- */
-export declare function scrapbookDir(projectRoot: string, config: DeskworkConfig, site: string, slug: string): string;
-/**
- * Resolve the scrapbook directory for an arbitrary path under the site's
- * content directory. Used by Phase 19c+ callers (e.g. the studio) that
- * already know the fs-relative path of an organizational or tracked node
- * and don't want to re-derive it through the slug regex. The path may
- * contain `/` segments; no `..` or absolute paths allowed.
- *
- * Path-shape validation matches `assertSlug` since the on-disk layout
- * is the same shape — kebab-case segments separated by `/`. Different
- * helper, same constraint.
- */
-export declare function scrapbookDirAtPath(projectRoot: string, config: DeskworkConfig, site: string, relPath: string): string;
-/**
- * Resolve the scrapbook directory for a tracked calendar entry.
- *
- * Derives the scrapbook location from the parent directory of the
- * entry's content file (located via `findEntryFile`, which prefers the
- * frontmatter-id index over the slug template). Falls back to today's
- * slug-based addressing for entries that haven't been bound to
- * frontmatter yet (pre-doctor state).
- *
- * Refactor-proof: when the operator renames an entry's directory on
- * disk, the next request rebuilds the index and the scrapbook now
- * lives at the new path automatically.
- *
- * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
- *              used both as the legacy fallback and to locate the
- *              `<dirname>/scrapbook/` when the entry has no id yet.
- * @param index Optional pre-built index (per-request memoization). When
- *              omitted, this function builds one.
- */
-export declare function scrapbookDirForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
-    id?: string;
-    slug: string;
-}, index?: ContentIndex): string;
-/** Options that select between the public scrapbook root and `secret/`. */
-export interface ScrapbookLocation {
-    /** When true, the file lives under `scrapbook/secret/`. Default: false. */
-    secret?: boolean;
-}
-/**
- * Resolve a filename INSIDE a scrapbook dir and return the absolute
- * path. Throws if the resolved path escapes the scrapbook dir (guards
- * against `..` sequences that slipped through assertFilename).
- *
- * When `opts.secret` is true, the returned path is rooted at
- * `<scrapbook>/secret/<filename>` instead of `<scrapbook>/<filename>`.
- */
-export declare function scrapbookFilePath(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): string;
-/**
- * Resolve a filename inside an already-resolved scrapbook directory.
- * Mirrors `listScrapbookAtDir` — used by callers that have already
- * resolved the on-disk dir via `scrapbookDirForEntry` (id-driven) or
- * `scrapbookDirAtPath` (fs-path-driven) and don't want to re-derive
- * through the slug template.
- *
- * Same security guards as `scrapbookFilePath`:
- *   - `assertFilename` blocks dotfiles / `..` / absolute paths in the filename
- *   - the `startsWith(dir + '/')` containment check blocks any traversal
- *     that slipped through (so `secret/` always sits inside the top-level
- *     scrapbook dir)
- *
- * The slug-shape validator is bypassed because the caller has already
- * proven the directory exists in the content tree by other means.
- */
-export declare function scrapbookFilePathAtDir(scrapbookDirAbs: string, filename: string, opts?: ScrapbookLocation): string;
-export declare function classify(filename: string): ScrapbookItemKind;
-/**
- * List the items in a scrapbook, sorted newest-mtime first. Returns
- * both public items (top-level files) and secret items (files inside
- * `scrapbook/secret/`). Subdirectories at the top level OTHER than
- * `secret/` are ignored — deskwork doesn't recurse into arbitrary
- * trees inside a scrapbook.
- */
-export declare function listScrapbook(projectRoot: string, config: DeskworkConfig, site: string, slug: string): ScrapbookSummary;
-/**
- * List a scrapbook by absolute directory path. Used by callers that
- * have already resolved the on-disk path via `scrapbookDirForEntry`
- * (id-driven) or `scrapbookDirAtPath` (fs-path-driven) and don't want
- * to re-derive through the slug template. The `slug` parameter is only
- * used to populate the returned summary's identifier field — it does
- * not influence path resolution.
- *
- * Internal primitive shared by `listScrapbook` (slug-based) and
- * `listScrapbookForEntry` (id-driven).
- */
-export declare function listScrapbookAtDir(site: string, slug: string, dir: string): ScrapbookSummary;
-/**
- * List scrapbook items for a tracked calendar entry. Resolves the
- * scrapbook directory via the content index when available (id binding),
- * falling back to slug-based addressing for entries that haven't been
- * bound to frontmatter yet (pre-doctor state).
- *
- * Mirrors the shape of `countScrapbookForEntry`. Used by the studio
- * review-page drawer + content-detail panel so writingcontrol-shape
- * entries (where the file path diverges from the slug template) list
- * items at the correct on-disk location.
- *
- * @param entry Calendar entry — `id` preferred; `slug` is both the
- *              legacy fallback and the disambiguator the underlying
- *              resolver uses when the index is incomplete.
- * @param index Optional pre-built per-request index. When omitted, the
- *              resolver builds one on demand.
- */
-export declare function listScrapbookForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
-    id?: string;
-    slug: string;
-}, index?: ContentIndex): ScrapbookSummary;
-/**
- * Total item count (public + secret). Used by the studio chip for the
- * badge — operators want a single "has scrapbook content" signal that
- * counts everything attached to this entry.
- *
- * Slug-based addressing: resolves `<contentDir>/<slug>/scrapbook/`. For
- * entries whose on-disk path doesn't match the slug template (e.g.
- * writingcontrol-shape projects where slug `the-outbound` lives at
- * `projects/the-outbound/index.md`), use `countScrapbookForEntry`
- * instead — it derives the path from the bound file via the content
- * index.
- */
-export declare function countScrapbook(projectRoot: string, config: DeskworkConfig, site: string, slug: string): number;
-/**
- * Count scrapbook items for a tracked calendar entry. Resolves the
- * scrapbook directory via the content index when available (id binding),
- * falling back to slug-based addressing for entries that haven't been
- * bound to frontmatter yet (pre-doctor state).
- *
- * Mirrors the shape of `scrapbookDirForEntry` — same resolver, same
- * legacy-slug fallback. Used by the studio dashboard chip so writing-
- * control-shape entries (where the file path diverges from the slug
- * template) report the correct count.
- *
- * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
- *              both the legacy fallback and the disambiguator the
- *              underlying resolver uses when the index is incomplete.
- * @param index Optional pre-built per-request index. When omitted, the
- *              resolver builds one on demand.
- */
-export declare function countScrapbookForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
-    id?: string;
-    slug: string;
-}, index?: ContentIndex): number;
-export declare function readScrapbookFile(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): {
-    name: string;
-    kind: ScrapbookItemKind;
-    size: number;
-    mtime: string;
-    content: Buffer;
-};
-/**
- * Read a scrapbook file given the absolute scrapbook directory. Used
- * by callers that have already resolved the on-disk dir via
- * `scrapbookDirForEntry` (id-driven) or `scrapbookDirAtPath`
- * (fs-path-driven) and don't want to re-derive through the slug
- * template. Mirrors the listing-side primitive `listScrapbookAtDir`.
- *
- * Same security guards as `readScrapbookFile` (filename validation +
- * path-traversal containment) via `scrapbookFilePathAtDir`.
- */
-export declare function readScrapbookFileAtDir(scrapbookDirAbs: string, filename: string, opts?: ScrapbookLocation): {
-    name: string;
-    kind: ScrapbookItemKind;
-    size: number;
-    mtime: string;
-    content: Buffer;
-};
-/**
- * Read a scrapbook file for a tracked calendar entry. Mirrors
- * `listScrapbookForEntry` / `countScrapbookForEntry` — id-driven
- * resolution via `scrapbookDirForEntry`, slug fallback for pre-bound
- * entries. Used by the studio's `/api/dev/scrapbook-file?entryId=...`
- * variant so projects whose feature-doc layout doesn't match the
- * kebab-case slug template (e.g. `docs/<version>/<status>/<feature>/`)
- * can still serve scrapbook assets — `scrapbookDirAtPath`'s slug
- * validator would otherwise reject any path with dots or uppercase
- * segments.
- *
- * Same security guards as the slug-shape variant: `assertFilename`
- * blocks dotfiles / `..` / absolute paths in the filename; the
- * `startsWith(dir + '/')` containment check blocks any traversal that
- * slipped through.
- */
-export declare function readScrapbookFileForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
-    id?: string;
-    slug: string;
-}, filename: string, opts?: ScrapbookLocation, index?: ContentIndex): {
-    name: string;
-    kind: ScrapbookItemKind;
-    size: number;
-    mtime: string;
-    content: Buffer;
-};
-/**
- * Create a new markdown note in the scrapbook. Creates the scrapbook
- * dir (and `secret/` subdir, if needed) if it doesn't exist. Refuses
- * to overwrite existing files.
- */
-export declare function createScrapbookMarkdown(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, body: string, opts?: ScrapbookLocation): ScrapbookItem;
-/** Overwrite an existing file's contents. Refuses if the file is absent. */
-export declare function saveScrapbookFile(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, body: string | Buffer, opts?: ScrapbookLocation): ScrapbookItem;
-export declare function renameScrapbookFile(projectRoot: string, config: DeskworkConfig, site: string, slug: string, oldName: string, newName: string, opts?: ScrapbookLocation): ScrapbookItem;
-export declare function deleteScrapbookFile(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): void;
-/**
- * Seed a scrapbook's `README.md` at plan time. Idempotent — if the
- * README already exists, returns null without touching it. Used by
- * the plan skill so every Planned article gets a scrapbook home with
- * a template that names the article and invites receipts.
- */
-export declare function seedScrapbookReadme(projectRoot: string, config: DeskworkConfig, site: string, slug: string, title: string): ScrapbookItem | null;
-/**
- * Write an uploaded file into the scrapbook. Filename + content come
- * from the multipart body upstream; we validate and persist.
- */
-export declare function writeScrapbookUpload(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, content: Buffer, opts?: ScrapbookLocation): ScrapbookItem;
-export declare function formatRelativeTime(iso: string, now?: Date): string;
-export declare function formatSize(bytes: number): string;
+export type { ScrapbookItem, ScrapbookItemKind, ScrapbookLocation, ScrapbookSummary, } from './scrapbook/types.ts';
+export { SECRET_SUBDIR } from './scrapbook/types.ts';
+export { assertFilename, assertSlug, classify, isNestedSlug, SLUG_SEGMENT_RE, slugSegments, } from './scrapbook/validation.ts';
+export { scrapbookDirAtPath, scrapbookDirForEntry, scrapbookFilePathAtDir, } from './scrapbook/paths.ts';
+export { countScrapbook, countScrapbookForEntry, listScrapbook, listScrapbookAtDir, listScrapbookForEntry, } from './scrapbook/listing.ts';
+export { readScrapbookFile, readScrapbookFileAtDir, readScrapbookFileForEntry, } from './scrapbook/read.ts';
+export { createScrapbookMarkdownAtDir, deleteScrapbookFileAtDir, renameScrapbookFileAtDir, saveScrapbookFileAtDir, writeScrapbookUploadAtDir, } from './scrapbook/crud-at-dir.ts';
+export { seedScrapbookReadme } from './scrapbook/seed.ts';
+export { formatRelativeTime, formatSize } from './scrapbook/format.ts';
 //# sourceMappingURL=scrapbook.d.ts.map

package/dist/scrapbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrapbook.d.ts","sourceRoot":"","sources":["../src/scrapbook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scrapbook.d.ts","sourceRoot":"","sources":["../src/scrapbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}