@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/project.js

@@ -0,0 +1,499 @@
+/**
+ * A room's project (ADR 0220): one git repository per room, which Chips holds and serves over
+ * git's own smart HTTP. Every agent in the room works in a clone of its own, and its bridge does
+ * the git (ADR 0221); a person's device clones it with a token that holds for ten minutes.
+ *
+ * - **One branch.** `main`, which a push may move forward and never rewrite or delete.
+ * - **Who.** A harness, for one of its agents in the room, named in `chips-actor`; or a person in
+ *   the room, with a project token from `POST /v1/spaces/:id/project/token`.
+ * - **What it won't keep.** A secrets file (`.env`, `.env.local`), anything that looks like a
+ *   key, and a file over the workspace's cap for files.
+ *
+ * The server, the conformance fake and the SDK name the same paths and the same header, and look
+ * for secrets the same way, so those live here.
+ */
+import { z } from "zod";
+import { isoTimestamp } from "./primitives.js";
+/** The one branch a room's project has. */
+export const PROJECT_BRANCH = "main";
+/** Where a room's project is served: what a clone's remote URL ends in. */
+export function projectPath(spaceId) {
+    return `/v1/spaces/${spaceId}/project.git`;
+}
+/**
+ * The room a request to its project names, and what follows `project.git`; nothing when the path
+ * is not a project's.
+ */
+export function projectRequest(path) {
+    const match = /^\/v1\/spaces\/(spc_[0-7][0-9A-HJKMNP-TV-Z]{25})\/project\.git(\/.*)?$/.exec(path);
+    if (match === null)
+        return undefined;
+    return { spaceId: match[1] ?? "", rest: match[2] ?? "/" };
+}
+/** The header a harness names the agent it fetches or pushes for with (ADR 0087). */
+export const PROJECT_ACTOR_HEADER = "chips-actor";
+/** The oldest git that takes a token through its environment (`GIT_CONFIG_COUNT`). */
+export const PROJECT_GIT_VERSION = "2.31.0";
+/** How long a person's project token holds. */
+export const PROJECT_TOKEN_TTL_SECONDS = 600;
+/** The prefix a project token wears, as a harness token wears `chips_at_`. */
+export const PROJECT_TOKEN_PREFIX = "chips_pt_";
+/** `POST /v1/spaces/:id/project/token`'s answer. */
+export const projectToken = z.object({
+    token: z
+        .string()
+        .startsWith(PROJECT_TOKEN_PREFIX)
+        .describe("Good for this room's project only, until `expires_at`: as a bearer token, or as the password of git's credential helper."),
+    expires_at: isoTimestamp,
+    path: z
+        .string()
+        .describe("The project's path on this server, which the device puts its own address in front of."),
+});
+/**
+ * `POST /v1/spaces/:id/project/folder/open`'s answer (ADR 0225): how many of the person's own
+ * Macs were sent `folder.open`. Nought means Chips for Mac isn't open anywhere.
+ */
+export const projectFolderOpenAnswer = z.object({
+    macs: z.int().nonnegative().describe("How many of the person's Macs were asked."),
+    opened_app: z
+        .literal(true)
+        .optional()
+        .describe("No Chips for Mac of theirs was open, so the server opened the one on its own machine and waited for it (ADR 0227)."),
+});
+/**
+ * The agents' and Chips's own folder at the project's top (ADR 0227): the start page and the run
+ * file. Files leaves it out, and Finder hides it as it hides `.git`.
+ */
+export const CHIPS_FOLDER = ".chips";
+/** The file that says how the project runs on the person's Mac (ADRs 0226, 0227). */
+export const RUN_FILE = ".chips/run.json";
+/** Where the run file was kept before ADR 0227, read when there is no `RUN_FILE`. */
+export const RUN_FILE_BEFORE = "chips.json";
+/** The page that links to the documents worth seeing, which Universe opens (ADR 0227). */
+export const START_PAGE = ".chips/index.html";
+/**
+ * What a link to a file of the project becomes when chipsd builds a page (ADR 0227): this, then the
+ * path, encoded as a URI component. The phone's page view opens the file over the page; in a frame,
+ * the builder's script hands the path to the window as `{chipsFile: path}`.
+ */
+export const FILE_LINK = "chips-file:";
+/** The longest command Run runs. */
+const RECIPE_MOST = 500;
+/** The longest a press names: setup, run and what it opens, as `folder.run` carries it. */
+const COMMAND_MOST = 1100;
+/**
+ * The run file's recipe, or why it isn't one: the Mac reads it before it runs anything, and the
+ * phone and the web read it to show what Run does. `opens` is never somewhere on the internet.
+ * `file` is the run file it was read from, which its words name.
+ */
+export function runRecipe(text, file = RUN_FILE) {
+    let said;
+    try {
+        said = JSON.parse(text);
+    }
+    catch {
+        return { why: `${file} isn't JSON.` };
+    }
+    const fields = (typeof said === "object" && said !== null ? said : {});
+    const field = (key) => {
+        const value = fields[key];
+        return typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
+    };
+    const run = field("run");
+    const opens = field("opens");
+    const setup = field("setup");
+    const why = whyNot(file, run, opens, setup);
+    if (why !== undefined)
+        return { why };
+    if (saysTooMuch({ run, opens, setup }))
+        return { why: `${file} says more than Chips runs.` };
+    if (opens !== undefined && !opensOnTheMac(opens)) {
+        return {
+            why: `${file} opens ${opens}, and Run opens only the Mac's own addresses and the project's files.`,
+        };
+    }
+    if (opens !== undefined && opensAProgram(opens)) {
+        return {
+            why: `${file} opens ${opens}, which the Mac would run as a program. Say how to start it as "run", where you see what it does.`,
+        };
+    }
+    return {
+        ...(run === undefined ? {} : { run }),
+        ...(opens === undefined ? {} : { opens }),
+        ...(setup === undefined ? {} : { setup }),
+    };
+}
+/** Whether a recipe is longer than Run runs, a part of it or the whole of what a press names. */
+function saysTooMuch(recipe) {
+    const { run, opens, setup } = recipe;
+    if ([run, opens, setup].some((each) => (each?.length ?? 0) > RECIPE_MOST))
+        return true;
+    return commandOf(recipe).length > COMMAND_MOST;
+}
+/** Why a recipe can't be one before its lengths and its address are looked at: nothing to start, or elsewhere. */
+function whyNot(file, run, opens, setup) {
+    return startless(file, run, opens, setup) ?? leavesFolder(file, run, setup);
+}
+/**
+ * Why a recipe that runs something outside the project's folder can't be one: a `cd` or `pushd`
+ * anywhere but into it, or a path in a home folder on this Mac. What it runs belongs in the
+ * project, so it runs on any Mac that has the project and is what the project holds (the game of
+ * life sim, 24 October 2026: its run file went into its agent's own workspace, and the project
+ * held nothing but the run file).
+ */
+function leavesFolder(file, run, setup) {
+    const away = [setup, run].map((each) => (each === undefined ? undefined : outsideOf(each)));
+    const at = away.find((each) => each !== undefined);
+    if (at === undefined)
+        return undefined;
+    return `${file} uses ${at}, outside the project's folder. Ask the agents to put what it runs in the project.`;
+}
+/** A place a command reaches outside the folder it runs in, or nothing. */
+function outsideOf(command) {
+    for (const [, to = ""] of command.matchAll(CD)) {
+        const at = to.replace(/^(["'])(.*)\1$/, "$2");
+        if (/^(?:\/|~|\$|\.\.(?:\/|$))/.test(at))
+            return at;
+    }
+    return HOME_PATH.exec(command)?.[1];
+}
+/** `cd` or `pushd` and where to, quoted or not. */
+const CD = /(?:^|[\s;&|(])(?:cd|pushd)\s+("[^"]*"|'[^']*'|[^\s;&|)]+)/g;
+/** A path in a home folder: `~/…`, `$HOME/…`, `/Users/<name>/…`, `/home/<name>/…`. */
+const HOME_PATH = /(?:^|[\s"'=:(])((?:~|\$HOME|\$\{HOME\}|\/Users\/[^/\s"';&|)]+|\/home\/[^/\s"';&|)]+)(?:\/[^\s"';&|)]*)?)/;
+/** Why a recipe with nothing to run can't be one: only a file of the project is opened on its own. */
+function startless(file, run, opens, setup) {
+    if (run !== undefined)
+        return undefined;
+    if (opens === undefined)
+        return `${file} doesn't say what to run or open.`;
+    if (/^https?:\/\//i.test(opens))
+        return `${file} opens ${opens} but doesn't say what to run.`;
+    if (setup !== undefined)
+        return `${file} has a setup but nothing to run.`;
+    return undefined;
+}
+/**
+ * What a press runs, as the Mac compares it with its folder's run file: setup, then run, then
+ * `open` and what it opens. What it opens is part of it, so a run file that changed only where it
+ * opens is shown again before it runs (SEC-46).
+ */
+export function commandOf(recipe) {
+    const opens = recipe.opens === undefined ? undefined : `open ${recipe.opens}`;
+    return [recipe.setup, recipe.run, opens].filter((line) => line !== undefined).join("\n");
+}
+/**
+ * Files the Mac runs when it opens them: an app, a script Terminal or a launcher runs, an installer,
+ * a link elsewhere. A document, a picture or a page opens in its app; these start only as `run`.
+ */
+const PROGRAM = /\.(?:app|command|tool|sh|zsh|bash|csh|ksh|py|rb|pl|jar|pkg|mpkg|dmg|terminal|workflow|action|applescript|scpt|scptd|webloc|inetloc|fileloc)$/i;
+/**
+ * Whether opening a path runs a program, by its last part once `.`, `..` and slashes are settled
+ * as the Mac settles them: `play.command/.` is `play.command` (SEC-46). The Mac asks again of the
+ * file it opens, after links.
+ */
+export function opensAProgram(path) {
+    const parts = [];
+    for (const part of path.split("/")) {
+        if (part === "..")
+            parts.pop();
+        else if (part !== "" && part !== ".")
+            parts.push(part);
+    }
+    return PROGRAM.test(parts.at(-1) ?? "");
+}
+/** An address on the Mac itself, or a file in the project. */
+function opensOnTheMac(opens) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(opens)) {
+        if (!/^https?:\/\//i.test(opens))
+            return false;
+        try {
+            const { hostname } = new URL(opens);
+            return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+        }
+        catch {
+            return false;
+        }
+    }
+    return !opens.startsWith("/") && !opens.split(/[\\/]/).includes("..");
+}
+/**
+ * What Run shows of `opens`: `localhost:8000`, or the file's name. An address of this Mac's own,
+ * `127.0.0.1` or `[::1]`, which Run opens to reach exactly where a program listens (ADR 0230),
+ * reads as `localhost`.
+ */
+export function opensShown(opens) {
+    return opens
+        .replace(/^https?:\/\//i, "")
+        .replace(/^(?:127\.0\.0\.1|\[::1\])(?=[:/]|$)/, "localhost")
+        .replace(/\/$/, "");
+}
+/** A run of the room's project on the person's Mac (ADR 0226), as that Mac tells it. */
+export const projectRun = z.object({
+    state: z
+        .enum(["never", "starting", "running", "ended", "failed", "stopped", "opened"])
+        .describe("Never run on that Mac; starting (setup, or waiting for it to answer); running; ended by itself; failed; stopped by the person; or opened, for pages that need no starting."),
+    command: z
+        .string()
+        .max(COMMAND_MOST)
+        .optional()
+        .describe("What ran: `setup`, `run` and `open` with what it opens, a line each; the bar compares it with the recipe's."),
+    commit: z
+        .string()
+        .regex(/^[0-9a-f]{40}(?:[0-9a-f]{24})?$/)
+        .optional()
+        .describe("The room's `main` the folder had when it started, so the bar can name who changed the files since (SEC-40)."),
+    since: isoTimestamp.optional(),
+    ended: isoTimestamp.optional(),
+    code: z.int().optional().describe("How it ended, as its shell said."),
+    opened: z.string().max(600).optional().describe("What it opened, once it answered."),
+    lines: z
+        .array(z.string().max(400))
+        .max(20)
+        .optional()
+        .describe("Its last lines, when it ended, or while it runs and something went wrong."),
+    why: z
+        .string()
+        .max(400)
+        .optional()
+        .describe("Why the Mac didn't run it when it was last asked, in its words: no run file, or a different one."),
+    trouble: z
+        .string()
+        .max(400)
+        .optional()
+        .describe("What went wrong with the run itself, in plain words (ADR 0230): a port in use, a program the Mac doesn't have, nothing answering, the browser refusing its address."),
+});
+/** A run as the server holds it for the person's other devices: which Mac said it, and when. */
+export const heldRun = projectRun.extend({
+    mac: z.string().min(1).max(120).describe("The name of the Mac it runs on."),
+    said_at: isoTimestamp,
+});
+/**
+ * `GET /v1/spaces/:id/project/run`'s answer: how the person's last run of the room stands, as
+ * their Mac last said, and how many of their Macs are open now to run or stop it.
+ */
+export const projectRunAnswer = z.object({
+    run: heldRun.optional(),
+    macs: z.int().nonnegative(),
+});
+/** A git object id: SHA-1, or SHA-256 for a repository made with it. */
+export const commitId = z
+    .string()
+    .regex(/^[0-9a-f]{40}(?:[0-9a-f]{24})?$/)
+    .describe("A commit, by its full git object id.");
+/** The most files `project.changed` names; the rest are counted. */
+export const PROJECT_CHANGED_FILES = 200;
+export const projectChangedFile = z.object({
+    path: z.string().min(1).max(1024).describe("Its path in the project, with `/` between folders."),
+    added: z.int().nonnegative().nullable().describe("Lines added; `null` for a binary file."),
+    removed: z.int().nonnegative().nullable().describe("Lines removed; `null` for a binary file."),
+});
+export const projectChangedPayload = z.object({
+    by: z
+        .string()
+        .min(1)
+        .max(120)
+        .describe("Who pushed: the agent a harness named, or the person. Recorded by Chips."),
+    before: commitId.nullable().describe("Where `main` was, or `null` for the project's first push."),
+    after: commitId.describe("Where `main` is now."),
+    commits: z.int().positive().describe("How many commits the push added to `main`."),
+    message: z.string().max(300).describe("The first line of the newest commit's message."),
+    files: z
+        .array(projectChangedFile)
+        .max(PROJECT_CHANGED_FILES)
+        .describe("What changed between `before` and `after`, in path order."),
+    more_files: z.int().positive().optional().describe("How many more files changed than are named."),
+    file_count: z
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("How many files `main` has now, for the room sheet's Project tile (ADR 0222)."),
+    undoes: commitId
+        .optional()
+        .describe("The change this one takes back, when it is a person's Undo, or Put it back's Undo of an Undo (ADR 0222)."),
+});
+/**
+ * A name that says a file holds secrets, `.env`, `.env.local` and the like, and the names of the
+ * examples people commit, `.env.example`, `.env.sample` and `.env.template`, which don't. Sources,
+ * as `SECRET_SHAPES` are.
+ */
+export const SECRETS_FILE = {
+    source: "^\\.env(?:\\..+)?$",
+    unless: "^\\.env\\.(?:example|sample|template)$",
+};
+const SECRETS_NAME = new RegExp(SECRETS_FILE.source);
+const EXAMPLE_NAME = new RegExp(SECRETS_FILE.unless);
+/** Whether a file's name says it holds secrets, wherever it is in the project. */
+export function isSecretsFile(path) {
+    const name = path.split("/").pop() ?? path;
+    return SECRETS_NAME.test(name) && !EXAMPLE_NAME.test(name);
+}
+/**
+ * What a key looks like, by whose it is: the shapes a push is refused for. Sources, not
+ * expressions, since the server's check runs in git's hook, a process of its own.
+ */
+export const SECRET_SHAPES = [
+    { what: "a Chips token", source: "chips_(?:at|inv|j|pt)_[A-Za-z0-9_-]{20,}" },
+    // `sk-` begins a word, so a link's words ("…/elon-musk-terafab-project-…") are never a key.
+    { what: "an Anthropic key", source: "\\bsk-ant-[A-Za-z0-9_-]{20,}" },
+    { what: "an OpenAI key", source: "\\bsk-(?:proj-|svcacct-|admin-)?[A-Za-z0-9_-]{40,}" },
+    { what: "an AWS access key", source: "\\b(?:AKIA|ASIA)[0-9A-Z]{16}\\b" },
+    {
+        what: "a GitHub token",
+        source: "\\b(?:gh[pousr]_[A-Za-z0-9]{36,}|github_pat_[A-Za-z0-9_]{60,})",
+    },
+    { what: "a private key", source: "-----BEGIN (?:[A-Z]+ )*PRIVATE KEY-----" },
+];
+const SHAPES = SECRET_SHAPES.map((shape) => ({
+    what: shape.what,
+    pattern: new RegExp(shape.source),
+}));
+/** Whose key a file's words hold, by the first shape they match, or nothing. */
+export function secretIn(text) {
+    return SHAPES.find((shape) => shape.pattern.test(text))?.what;
+}
+/**
+ * What an agent's copy never commits, written into the copy's own `info/exclude` (ADR 0221): what
+ * a build or a package manager makes, what macOS leaves, and secrets files, but not their examples.
+ */
+export const PROJECT_LEAVE_OUT = [
+    "node_modules/",
+    ".venv/",
+    "__pycache__/",
+    "dist/",
+    "build/",
+    ".DS_Store",
+    ".env",
+    ".env.*",
+    "!.env.example",
+    "!.env.sample",
+    "!.env.template",
+];
+/** `a, b and c`, or the first six and how many more. */
+export function namesInWords(names) {
+    if (names.length <= 1)
+        return names[0] ?? "";
+    if (names.length > 6)
+        return `${names.slice(0, 6).join(", ")} and ${names.length - 6} more`;
+    return `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
+}
+/**
+ * The note an agent's turn opens its project with: where its copy is and that the bridge does the
+ * git, what others changed, a clash to settle or a key to take out, and, in a room with other
+ * agents, how to share the work. Its facts, then its asks (ADR 0250).
+ */
+export function renderProjectNote(facts, options) {
+    return `${renderProjectFacts(facts)}\n${renderProjectAsks(facts, options)}`;
+}
+/**
+ * What a turn is told of its copy of the project (ADR 0221): where it is, what others changed, and
+ * a clash to settle or a key to take out. Said with every turn.
+ */
+export function renderProjectFacts(facts) {
+    const files = `${facts.files} file${facts.files === 1 ? "" : "s"}`;
+    const lines = [
+        `The space's project is a git repository. Your copy is ${facts.folder} (${files}), ${facts.trouble === undefined ? "brought up to date just now" : "not brought up to date"}.`,
+    ];
+    if (facts.changed.length > 0) {
+        const by = facts.by.length > 0 ? `, by ${namesInWords(facts.by)}` : "";
+        lines.push(`Changed since your last turn: ${namesInWords(facts.changed)}${by}.`);
+    }
+    if (facts.trouble !== undefined)
+        lines.push(`It couldn't be: ${facts.trouble}`);
+    if (facts.clashes.length > 0) {
+        const whose = facts.clashedWith.length > 0 ? `${namesInWords(facts.clashedWith)}'s` : "another change";
+        lines.push(`Your last change to ${namesInWords(facts.clashes)} clashed with ${whose}, which reached the space first. Both sides are in those files now: yours between "<<<<<<< yours" and "=======", theirs from there to the ">>>>>>>" line that names them. Settle each, keeping what both meant, and take the marks out. Nothing of yours is sent until they're gone.`);
+    }
+    for (const key of facts.keys) {
+        lines.push(`${key.path} holds what looks like ${key.what}, so your last change wasn't sent: take it out and read it from outside the project.`);
+    }
+    return lines.join("\n");
+}
+/**
+ * What the note asks of every turn: where to work, and how, for the room and the files it has. The
+ * same from turn to turn while the project and the room keep their shape, so a session that keeps
+ * its earlier turns may be told them once (ADR 0250).
+ */
+export function renderProjectAsks(facts, options) {
+    const lines = [
+        "Work on the project in that folder and leave git to Chips: when your turn ends, what you changed is committed under your name and sent to everyone here. Keep scratch work outside it.",
+        // Sent with the answer too, a project's file became a room file of its own, with versions of
+        // its own, and the agents of a room argued over which copy was current (Phase 8, Run D).
+        "Everyone here sees the project's files, so don't send them with your answer as well.",
+    ];
+    if (options.othersInRoom) {
+        lines.push("Split the work by file where you can. Changes to different parts of a file are merged, and a clash goes back to whoever sent second.", 
+        // Agents whose files must agree each renamed theirs to match the other's at once, so the
+        // names crossed back and forth (Phase 8, AP-7): the project's history says who keeps theirs.
+        "When your file and another's use different names for the same thing, the one that reached the project first keeps its names, and the other changes its names to match.");
+    }
+    // Universe opens what the space made (ADR 0227): its documents in Chips, its program on the Mac.
+    lines.push("When what you make is to be read (pages, PDFs, pictures), keep a start page at .chips/index.html that links to the documents worth seeing (its links start ../), with the documents themselves at the top or in folders of their own, and bring it up to date whenever you add, rename or replace one. Chips opens it in the app, and its links open there too. One document needs no start page.", 'When what you make has to run on the person\'s Mac (a server, a script, an app), keep .chips/run.json so Run in Chips can start it from the project\'s folder: {"run": "the one shell command that starts it", "opens": "http://localhost:<port>, to open once it answers", "setup": "a command run first when it changes, like npm install"}. Have it print the address it listens on, like http://localhost:4173, which is what Run opens; "opens" is for a program that prints none. Everything it runs belongs in the project: Run refuses a command that goes anywhere outside the project\'s folder (a cd elsewhere, a path in a home folder). Start an app by its own program rather than with open, so Stop can close it, and leave starting it to Run rather than starting it yourself. Leave out what it doesn\'t need, and check it works in your copy before you say it does.');
+    if (facts.markdown)
+        lines.push("In Markdown, put each sentence on a line of its own.");
+    if (facts.pages === true) {
+        lines.push("A page opens in Chips as one document: name every file it needs in its tags and imports (<link>, <script src>, <img src>, import), since it can't fetch files while it runs.");
+    }
+    return lines.join("\n");
+}
+/** What a file of the project is, by its name's extension (ADR 0222): how a client opens it. */
+const PROJECT_FILE_TYPES = {
+    html: "text/html",
+    htm: "text/html",
+    md: "text/markdown",
+    markdown: "text/markdown",
+    txt: "text/plain",
+    csv: "text/csv",
+    css: "text/css",
+    js: "text/javascript",
+    mjs: "text/javascript",
+    json: "application/json",
+    svg: "image/svg+xml",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    pdf: "application/pdf",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+};
+/** Code and other words that open as plain text. */
+const PROJECT_TEXT = new Set([
+    "ts",
+    "tsx",
+    "jsx",
+    "py",
+    "rb",
+    "go",
+    "rs",
+    "java",
+    "kt",
+    "swift",
+    "c",
+    "h",
+    "cpp",
+    "sh",
+    "yml",
+    "yaml",
+    "toml",
+    "ini",
+    "xml",
+    "sql",
+    "gitignore",
+    "env",
+]);
+/** A project file's media type, by its name: `text/plain` for code, `application/octet-stream` for the rest. */
+export function projectFileType(path) {
+    const name = path.split("/").pop() ?? path;
+    const extension = name.includes(".") ? (name.split(".").pop() ?? "").toLowerCase() : "";
+    return (PROJECT_FILE_TYPES[extension] ??
+        (PROJECT_TEXT.has(extension) ? "text/plain" : "application/octet-stream"));
+}
+/** Whose a commit is, from the email Chips signs it with: an agent's or a person's id, or nothing. */
+export function committerId(email) {
+    return /^((?:agt|usr|hrn)_[0-9A-Za-z]+)@(?:agents|people)\.chips\.invalid$/.exec(email)?.[1];
+}
+//# sourceMappingURL=project.js.map

package/dist/src/project.js.map

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

package/dist/src/ranges.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What a `Range` header asks of an attachment's bytes (RFC 9110 §14), for
+ * `GET /v1/attachments/:id` (ADR 0058). A player seeks by asking for a run of the file, and
+ * AVPlayer will not start a video it cannot ask a run of; the server answers `206` with that run.
+ *
+ * One run, in bytes: a first and a last byte (`bytes=0-499`), a first byte and the rest
+ * (`bytes=500-`), or the last so many (`bytes=-500`). A last byte past the end means the end. A
+ * header this does not read — another unit, several runs, a last byte before the first — is
+ * ignored and the whole file is served, which the standard allows. A run that starts past the end,
+ * or asks for the last nought bytes, cannot be served: `416`.
+ *
+ * Here rather than in the server because the conformance kit's stand-in answers the same route
+ * and must answer it the same way.
+ */
+/** What to serve for a `Range` header, over a file of so many bytes. */
+export type RangeAnswer = {
+    readonly kind: "whole";
+}
+/** From `start` to `end`, both included, as `Content-Range` counts them. */
+ | {
+    readonly kind: "part";
+    readonly start: number;
+    readonly end: number;
+} | {
+    readonly kind: "unsatisfiable";
+};
+/** The run a `Range` header asks for, of a file `size` bytes long. */
+export declare function byteRange(header: string | null | undefined, size: number): RangeAnswer;
+/** `Content-Range` for a part of a file, or for a range that could not be served. */
+export declare function contentRange(answer: RangeAnswer, size: number): string | undefined;
+//# sourceMappingURL=ranges.d.ts.map

package/dist/src/ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.d.ts","sourceRoot":"","sources":["../../src/ranges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wEAAwE;AACxE,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE;AAC5B,4EAA4E;GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAQvC,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAKtF;AAgBD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlF"}

package/dist/src/ranges.js

@@ -0,0 +1,51 @@
+/**
+ * What a `Range` header asks of an attachment's bytes (RFC 9110 §14), for
+ * `GET /v1/attachments/:id` (ADR 0058). A player seeks by asking for a run of the file, and
+ * AVPlayer will not start a video it cannot ask a run of; the server answers `206` with that run.
+ *
+ * One run, in bytes: a first and a last byte (`bytes=0-499`), a first byte and the rest
+ * (`bytes=500-`), or the last so many (`bytes=-500`). A last byte past the end means the end. A
+ * header this does not read — another unit, several runs, a last byte before the first — is
+ * ignored and the whole file is served, which the standard allows. A run that starts past the end,
+ * or asks for the last nought bytes, cannot be served: `416`.
+ *
+ * Here rather than in the server because the conformance kit's stand-in answers the same route
+ * and must answer it the same way.
+ */
+const WHOLE = { kind: "whole" };
+const UNSATISFIABLE = { kind: "unsatisfiable" };
+/** `bytes=first-last`, either side of the dash possibly empty; the unit is case-insensitive. */
+const ONE_RUN = /^bytes[ \t]*=[ \t]*(\d*)[ \t]*-[ \t]*(\d*)[ \t]*$/i;
+/** The run a `Range` header asks for, of a file `size` bytes long. */
+export function byteRange(header, size) {
+    const run = header === null || header === undefined ? null : ONE_RUN.exec(header.trim());
+    if (run === null)
+        return WHOLE;
+    const [, first = "", last = ""] = run;
+    return first === "" ? lastBytes(last, size) : fromByte(Number(first), last, size);
+}
+/** `bytes=-500`: the last so many. Asking for none of them is asking for nothing that can be served. */
+function lastBytes(count, size) {
+    if (count === "")
+        return WHOLE;
+    if (Number(count) === 0 || size === 0)
+        return UNSATISFIABLE;
+    return { kind: "part", start: Math.max(0, size - Number(count)), end: size - 1 };
+}
+/** `bytes=500-999`, or `bytes=500-` for the rest. A last byte past the end is the end. */
+function fromByte(start, last, size) {
+    if (last !== "" && Number(last) < start)
+        return WHOLE;
+    if (start >= size)
+        return UNSATISFIABLE;
+    return { kind: "part", start, end: last === "" ? size - 1 : Math.min(Number(last), size - 1) };
+}
+/** `Content-Range` for a part of a file, or for a range that could not be served. */
+export function contentRange(answer, size) {
+    if (answer.kind === "part")
+        return `bytes ${answer.start}-${answer.end}/${size}`;
+    if (answer.kind === "unsatisfiable")
+        return `bytes */${size}`;
+    return undefined;
+}
+//# sourceMappingURL=ranges.js.map

package/dist/src/ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.js","sourceRoot":"","sources":["../../src/ranges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7C,MAAM,aAAa,GAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AAE7D,gGAAgG;AAChG,MAAM,OAAO,GAAG,oDAAoD,CAAC;AAErE,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,MAAiC,EAAE,IAAY;IACvE,MAAM,GAAG,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IACtC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,wGAAwG;AACxG,SAAS,SAAS,CAAC,KAAa,EAAE,IAAY;IAC5C,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,0FAA0F;AAC1F,SAAS,QAAQ,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY;IACzD,IAAI,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,aAAa,CAAC;IACxC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,IAAY;IAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,WAAW,IAAI,EAAE,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC"}