@sendbird/cli 0.0.0-stage → 0.3.0-alpha.1

package/dist/skills.js

@@ -0,0 +1,374 @@
+/** Offline registration of the bundled CLI Skill. Never installs client plugins or hooks. */
+import { createHash, randomUUID } from "node:crypto";
+import { lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { CliError, parse } from "./core.js";
+import { VERSION } from "./version.js";
+const agents = ["claude", "codex"];
+const scopes = ["project", "user"];
+const receiptName = ".sendbird-cli-skill.json";
+const source = fileURLToPath(new URL("../skills/sendbird/", import.meta.url));
+const licensePath = fileURLToPath(new URL("../LICENSE", import.meta.url));
+const digest = (s) => createHash("sha256").update(s).digest("hex");
+const fail = (message) => {
+    throw new CliError("E_SKILL_INSTALL", message, 2);
+};
+function present(path) {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return false;
+        throw e;
+    }
+}
+/** No symlinks or special files; bounded inspection never follows an unmanaged tree. */
+function tree(root) {
+    const files = Object.create(null);
+    let bytes = 0, entries = 0;
+    const walk = (dir) => {
+        if (!lstatSync(dir).isDirectory() || lstatSync(dir).isSymbolicLink())
+            fail("Skill directory is not a regular directory");
+        for (const entry of readdirSync(dir).sort()) {
+            if (++entries > 256)
+                fail("Skill tree exceeds the entry limit");
+            if (dir === root && entry === receiptName)
+                continue;
+            const path = join(dir, entry), st = lstatSync(path);
+            if (st.isSymbolicLink())
+                fail("Skill contains a symlink; no files were changed");
+            if (st.isDirectory()) {
+                files[relative(root, path).split(sep).join("/") + "/"] =
+                    Buffer.alloc(0);
+                walk(path);
+            }
+            else {
+                if (!st.isFile() ||
+                    st.size > 1024 * 1024 ||
+                    Object.keys(files).length >= 128)
+                    fail("Skill tree is not a bounded regular-file installation");
+                bytes += st.size;
+                if (bytes > 2 * 1024 * 1024)
+                    fail("Skill tree exceeds the inspection limit");
+                files[relative(root, path).split(sep).join("/")] = readFileSync(path);
+            }
+        }
+    };
+    walk(root);
+    return files;
+}
+const hashes = (files) => Object.fromEntries(Object.keys(files)
+    .sort()
+    .map((path) => [path, digest(files[path])]));
+const fingerprint = (files) => digest(JSON.stringify(files));
+const receiptSchema = z
+    .object({
+    schema_version: z.literal(1),
+    owner: z.literal("@sendbird/cli"),
+    skill: z.literal("sendbird"),
+    agent: z.enum(agents),
+    scope: z.enum(scopes),
+    version: z.string(),
+    files: z.record(z.string(), z.string().regex(/^[a-f0-9]{64}$/)),
+    content_sha256: z.string().regex(/^[a-f0-9]{64}$/),
+})
+    .strict();
+function target(agent, scope) {
+    const base = realpathSync(scope === "project" ? process.cwd() : homedir());
+    const segments = [agent === "claude" ? ".claude" : ".agents", "skills"];
+    let parent = base;
+    for (const segment of segments) {
+        parent = join(parent, segment);
+        if (present(parent) &&
+            (!lstatSync(parent).isDirectory() || lstatSync(parent).isSymbolicLink()))
+            fail("Skill search path contains a symlink or non-directory; choose another scope");
+    }
+    return { agent, scope, parent, path: join(parent, "sendbird") };
+}
+function inspect(t, bundledHash) {
+    if (!present(t.path))
+        return {
+            ...t,
+            state: "not_registered",
+            version: null,
+            content_sha256: null,
+        };
+    try {
+        if (!lstatSync(t.path).isDirectory() || lstatSync(t.path).isSymbolicLink())
+            throw Error();
+        const receipt = join(t.path, receiptName);
+        if (!present(receipt) ||
+            !lstatSync(receipt).isFile() ||
+            lstatSync(receipt).isSymbolicLink() ||
+            lstatSync(receipt).size > 64 * 1024)
+            throw Error();
+        const r = receiptSchema.parse(JSON.parse(readFileSync(receipt, "utf8")));
+        if (r.agent !== t.agent ||
+            r.scope !== t.scope ||
+            fingerprint(r.files) !== r.content_sha256)
+            throw Error();
+        const actual = hashes(tree(t.path));
+        const clean = JSON.stringify(actual) === JSON.stringify(r.files);
+        return {
+            ...t,
+            state: !clean
+                ? "modified"
+                : r.content_sha256 === bundledHash && r.version === VERSION
+                    ? "current"
+                    : "update_available",
+            version: r.version,
+            content_sha256: r.content_sha256,
+        };
+    }
+    catch {
+        return { ...t, state: "unmanaged", version: null, content_sha256: null };
+    }
+}
+function transaction(t) {
+    return {
+        lock_present: present(join(t.parent, ".sendbird-cli-skill.lock")),
+        backup_paths: present(t.parent)
+            ? readdirSync(t.parent)
+                .filter((name) => name.startsWith(".sendbird-skill-backup-"))
+                .map((name) => join(t.parent, name))
+            : [],
+    };
+}
+/** Remove only a tree whose complete content/receipt was checked while holding our lock. */
+function erase(root) {
+    if (lstatSync(root).isSymbolicLink() || !lstatSync(root).isDirectory())
+        fail("Cleanup target changed; inspect the retained installation manually");
+    for (const entry of readdirSync(root)) {
+        const path = join(root, entry), st = lstatSync(path);
+        if (st.isDirectory() && !st.isSymbolicLink())
+            erase(path);
+        else
+            unlinkSync(path);
+    }
+    rmdirSync(root);
+}
+export function skillCommand(action, fields, opts = {}) {
+    parse(z.enum(["install", "remove", "status", "show"]), action);
+    const agent = fields.agent === undefined
+        ? undefined
+        : parse(z.enum(agents), fields.agent);
+    const scope = fields.scope === undefined
+        ? undefined
+        : parse(z.enum(scopes), fields.scope);
+    const files = tree(source);
+    files["LICENSE"] = readFileSync(licensePath);
+    const fileHashes = hashes(files), bundledHash = fingerprint(fileHashes);
+    if (action === "show") {
+        if (agent || scope)
+            fail("skills show does not take --agent or --scope");
+        return {
+            skill: "sendbird",
+            version: VERSION,
+            path: join(source, "SKILL.md"),
+            content: files["SKILL.md"].toString("utf8"),
+            references: Object.keys(files)
+                .filter((p) => p !== "SKILL.md" && !p.endsWith("/"))
+                .map((p) => (p === "LICENSE" ? licensePath : join(source, p))),
+            next: "Read the referenced files relative to the Skill path as needed. Registration is optional for this session.",
+        };
+    }
+    if (action === "status") {
+        const installations = (agent ? [agent] : agents).flatMap((a) => (scope ? [scope] : scopes).map((s) => {
+            try {
+                const t = target(a, s);
+                const { parent: _, ...status } = inspect(t, bundledHash);
+                return { ...status, transaction: transaction(t) };
+            }
+            catch {
+                return {
+                    agent: a,
+                    scope: s,
+                    path: null,
+                    state: "unsafe_path",
+                    version: null,
+                    content_sha256: null,
+                };
+            }
+        }));
+        return {
+            skill: "sendbird",
+            bundled_version: VERSION,
+            installations,
+            note: "Filesystem registration only; host loading and automatic invocation are not verified. Duplicate local/plugin Skills may coexist; do not install another copy if the host already provides this Skill.",
+        };
+    }
+    if (!agent)
+        fail("Specify --agent claude or --agent codex");
+    const t = target(agent, scope ?? "project"), state = inspect(t, bundledHash);
+    if (transaction(t).backup_paths.length)
+        fail("A retained Skill backup needs manual review; inspect skills status before another change");
+    if (["unmanaged", "modified"].includes(state.state))
+        fail("Existing Skill is unmanaged or modified; no files were changed. Choose another scope or resolve it manually");
+    if (action === "remove" && !opts.yes && !opts.dryRun)
+        throw new CliError("E_CONFIRMATION", "Removing a registered Skill requires --yes", 2);
+    const planned = action === "remove"
+        ? state.state === "not_registered"
+            ? "absent"
+            : "removed"
+        : state.state === "current"
+            ? "current"
+            : state.state === "not_registered"
+                ? "installed"
+                : "updated";
+    const result = {
+        skill: "sendbird",
+        agent: t.agent,
+        scope: t.scope,
+        path: t.path,
+        version: VERSION,
+        previous_version: state.version,
+        state: planned,
+        content_sha256: bundledHash,
+        host_loaded: null,
+        next: "Reload Skills or start a new host session if required, then check that sendbird is available. Installation does not guarantee automatic selection. Client plugins are installed separately through their official flow.",
+    };
+    if (opts.dryRun)
+        return {
+            ...result,
+            dry_run: true,
+            note: "Preview only; no files, profiles or credentials changed and no network requests were sent.",
+        };
+    if (["absent", "current"].includes(planned))
+        return result;
+    try {
+        mkdirSync(t.parent, { recursive: true });
+    }
+    catch {
+        fail(`Cannot create the Skill search directory. Run sendbird skills install --agent ${t.agent} --scope ${t.scope} in your normal terminal if your agent sandbox protects .agents or .claude; otherwise check directory permissions. No Skill was registered`);
+    }
+    // A lock coordinates CLI processes; this is not an OS boundary against hostile same-user changes.
+    const lock = join(t.parent, ".sendbird-cli-skill.lock");
+    try {
+        mkdirSync(lock);
+    }
+    catch {
+        fail("Another Skill registration is active or interrupted. Inspect skills status; never remove a live lock");
+    }
+    const staged = join(t.parent, `.sendbird-skill-${randomUUID()}`), backup = join(t.parent, `.sendbird-skill-backup-${randomUUID()}`);
+    let moved = false, published = false;
+    try {
+        const checked = inspect(t, bundledHash);
+        if (checked.state !== state.state ||
+            checked.content_sha256 !== state.content_sha256)
+            fail("Skill changed during registration; inspect status before retrying");
+        if (action !== "remove") {
+            mkdirSync(staged);
+            for (const [path, content] of Object.entries(files)) {
+                const destination = join(staged, path);
+                if (path.endsWith("/")) {
+                    mkdirSync(destination, { recursive: true });
+                    continue;
+                }
+                mkdirSync(dirname(destination), { recursive: true });
+                writeFileSync(destination, content, { flag: "wx", mode: 0o644 });
+            }
+            writeFileSync(join(staged, receiptName), JSON.stringify({
+                schema_version: 1,
+                owner: "@sendbird/cli",
+                skill: "sendbird",
+                agent: t.agent,
+                scope: t.scope,
+                version: VERSION,
+                files: fileHashes,
+                content_sha256: bundledHash,
+            }, null, 2) + "\n", { flag: "wx", mode: 0o644 });
+        }
+        if (present(t.path)) {
+            renameSync(t.path, backup);
+            moved = true;
+        }
+        if (action !== "remove") {
+            if (present(t.path))
+                fail("Skill destination changed; no replacement was attempted");
+            renameSync(staged, t.path);
+            published = true;
+        }
+        if (moved) {
+            if (fingerprint(hashes(tree(backup))) !== state.content_sha256)
+                fail("Skill backup changed; retained it for manual review");
+            erase(backup);
+        }
+        return result;
+    }
+    catch (error) {
+        if (moved && !published && !present(t.path) && present(backup))
+            renameSync(backup, t.path);
+        throw error instanceof CliError
+            ? error
+            : new CliError("E_SKILL_INSTALL", "Skill registration failed; inspect skills status and any retained backup before retrying", 2);
+    }
+    finally {
+        if (present(staged))
+            erase(staged);
+        rmdirSync(lock);
+    }
+}
+const entrySchema = z.object({
+    agent: z.enum(agents),
+    scope: z.enum(scopes),
+    path: z.string().nullable(),
+    state: z.enum([
+        "not_registered",
+        "unmanaged",
+        "modified",
+        "current",
+        "update_available",
+        "unsafe_path",
+    ]),
+    version: z.string().nullable(),
+    content_sha256: z.string().nullable(),
+    transaction: z
+        .object({ lock_present: z.boolean(), backup_paths: z.array(z.string()) })
+        .optional(),
+});
+export const skillSchemas = {
+    show: z.object({
+        skill: z.literal("sendbird"),
+        version: z.string(),
+        path: z.string(),
+        content: z.string(),
+        references: z.array(z.string()),
+        next: z.string(),
+    }),
+    status: z.object({
+        skill: z.literal("sendbird"),
+        bundled_version: z.string(),
+        installations: z.array(entrySchema),
+        note: z.string(),
+    }),
+    install: z.object({
+        skill: z.literal("sendbird"),
+        agent: z.enum(agents),
+        scope: z.enum(scopes),
+        path: z.string(),
+        version: z.string(),
+        previous_version: z.string().nullable(),
+        state: z.enum(["installed", "updated", "current", "removed", "absent"]),
+        content_sha256: z.string(),
+        host_loaded: z.null(),
+        next: z.string(),
+        dry_run: z.boolean().optional(),
+        note: z.string().optional(),
+    }),
+};
+export function skillSchema(command) {
+    if (!command.startsWith("skills "))
+        return;
+    const action = command.slice(7);
+    return action === "show"
+        ? skillSchemas.show
+        : action === "status"
+            ? skillSchemas.status
+            : skillSchemas.install;
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/value-semantics.d.ts

@@ -0,0 +1,70 @@
+/** Presentation/discovery metadata only. Never coerce API input or response DTOs.
+ * Interpretation rules: docs/value-semantics.md; mappings were checked against upstream sources.
+ */
+type Meaning = {
+    value: number;
+    name: string;
+    label: string;
+    description: string;
+};
+/** Paths are result-relative; original API fields are root-relative with --raw.
+ * CLI-added readback fields are absent from --raw; * means an array item.
+ * Known values document meaning, not entitlement, execution success or a write allowlist.
+ */
+export declare function valueSemantics(command: string): {
+    version: number;
+    path_root: string;
+    wildcard: string;
+    unknown_values: string;
+    input: string;
+    fields: ({
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "enum";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "sentinel";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    } | {
+        kind: "sentinel";
+        values: Meaning[];
+        path: string;
+        vocabulary: "guest_user_policy" | "unread_badge" | "profanity_mode" | "domain_mode" | "image_mode" | "image_likelihood" | "profanity_action" | "character_cap" | "message_rate";
+    })[];
+} | undefined;
+export declare function withValueSemantics(command: string, schema: Record<string, unknown>): Record<string, unknown>;
+/** A copy for human rendering only, after redaction. Arbitrary metadata is never traversed. */
+export declare function humanValueSemantics(command: string, result: unknown): unknown;
+export {};

package/dist/value-semantics.js

@@ -0,0 +1,173 @@
+const meaning = (value, name, label, description = label) => ({ value, name, label, description });
+const vocabularies = {
+    unread_badge: {
+        kind: "enum",
+        values: [meaning(0, "off", "Disabled"), meaning(1, "on", "Enabled")],
+    },
+    guest_user_policy: {
+        kind: "enum",
+        values: [
+            meaning(0, "read_write", "Tokenless read/write", "Chat users without an issued token may read and write, subject to channel permissions. Users with issued tokens still need them."),
+            meaning(1, "read_only", "Tokenless read only", "Chat users without an issued token may read but cannot send messages. This does not describe Calls permissions."),
+            meaning(2, "block", "Token required", "Tokenless SDK connections are blocked."),
+        ],
+    },
+    profanity_mode: {
+        kind: "enum",
+        values: [
+            meaning(0, "none", "Disabled"),
+            meaning(1, "replace", "Replace with asterisks"),
+            meaning(2, "block", "Block message"),
+            meaning(3, "detect", "Detect only", "Detect profanity without replacing or blocking the message. Other moderation rules may still apply."),
+        ],
+    },
+    domain_mode: {
+        kind: "enum",
+        values: [
+            meaning(0, "none", "Disabled"),
+            meaning(1, "pass_if_matched", "Allow listed domains"),
+            meaning(2, "block_if_matched", "Block listed domains"),
+            meaning(3, "replace_if_matched", "Replace listed domains"),
+        ],
+    },
+    image_mode: {
+        kind: "enum",
+        values: [
+            meaning(0, "none", "Disabled"),
+            meaning(1, "normal", "Normal"),
+            meaning(2, "strict", "Strict"),
+        ],
+    },
+    image_likelihood: {
+        kind: "enum",
+        values: [
+            meaning(0, "unknown", "Unknown likelihood"),
+            meaning(1, "very_unlikely", "Very unlikely"),
+            meaning(2, "unlikely", "Unlikely"),
+            meaning(3, "possible", "Possible"),
+            meaning(4, "likely", "Likely"),
+            meaning(5, "very_likely", "Very likely"),
+        ],
+    },
+    profanity_action: {
+        kind: "enum",
+        values: [
+            meaning(0, "none", "No action"),
+            meaning(1, "mute", "Mute user"),
+            meaning(2, "kick", "Kick user"),
+            meaning(3, "ban", "Ban user"),
+        ],
+    },
+    character_cap: {
+        kind: "sentinel",
+        values: [
+            meaning(-1, "no_app_cap", "No app character cap", "No application-level character cap. Other service limits can still apply."),
+        ],
+    },
+    message_rate: {
+        kind: "sentinel",
+        values: [
+            meaning(-1, "system_limit", "System limit", "Use the service's system limit, not unlimited messaging."),
+        ],
+    },
+};
+const settingBindings = [
+    { path: "profanity_filter.type", vocabulary: "profanity_mode" },
+    { path: "domain_filter.type", vocabulary: "domain_mode" },
+    { path: "image_moderation.type", vocabulary: "image_mode" },
+    ...["adult", "spoof", "medical", "violence", "racy"].map((category) => ({
+        path: `image_moderation.limits.${category}`,
+        vocabulary: "image_likelihood",
+    })),
+    {
+        path: "profanity_triggered_moderation.action",
+        vocabulary: "profanity_action",
+    },
+    { path: "max_message_length", vocabulary: "character_cap" },
+    { path: "user_messages_per_channel", vocabulary: "message_rate" },
+];
+function bindings(command) {
+    if (/^(chat|calls) push (list|create|update)$/.test(command) ||
+        command === "calls push delete") {
+        const path = "push_configurations.*.has_unread_count_badge";
+        const entries = command.endsWith(" delete")
+            ? []
+            : [{ path, vocabulary: "unread_badge" }];
+        if (command.startsWith("calls ") && !command.endsWith(" list"))
+            entries.push({
+                path: `readback.settings.${path}`,
+                vocabulary: "unread_badge",
+            });
+        return entries;
+    }
+    if (/^app auth-policy (get|set)$/.test(command) || command === "app get")
+        return [{ path: "guest_user_policy", vocabulary: "guest_user_policy" }];
+    if (/^chat settings (get|update)$/.test(command) ||
+        /^chat settings custom (get|create|update)$/.test(command))
+        return settingBindings;
+    if (command === "chat settings custom list")
+        return settingBindings.map((entry) => ({
+            ...entry,
+            path: `channel_custom_type_settings.*.${entry.path}`,
+        }));
+    if (/^chat moderation keywords (global|custom) (list|add|delete)$/.test(command))
+        return [settingBindings[0]];
+    return [];
+}
+/** Paths are result-relative; original API fields are root-relative with --raw.
+ * CLI-added readback fields are absent from --raw; * means an array item.
+ * Known values document meaning, not entitlement, execution success or a write allowlist.
+ */
+export function valueSemantics(command) {
+    const entries = bindings(command);
+    if (!entries.length)
+        return undefined;
+    return {
+        version: 1,
+        path_root: "result; original response fields are at the response root with --raw; CLI-added readback fields are absent from --raw",
+        wildcard: "* matches array items only",
+        unknown_values: "Preserve the raw value. Do not infer meaning or permissions for undocumented values.",
+        input: "Keep numeric wire values in requests. Check the command input schema; response meanings do not add writable fields or allowed input values.",
+        fields: entries.map(({ path, vocabulary }) => ({
+            path,
+            vocabulary,
+            ...vocabularies[vocabulary],
+        })),
+    };
+}
+export function withValueSemantics(command, schema) {
+    const semantics = valueSemantics(command);
+    return semantics
+        ? { ...schema, "x-sendbird-value-semantics": semantics }
+        : schema;
+}
+function humanValue(vocabulary, value) {
+    if (typeof value !== "number")
+        return value;
+    const definition = vocabularies[vocabulary];
+    const known = definition.values.find((entry) => entry.value === value);
+    if (known)
+        return `${known.label} (${value})`;
+    return definition.kind === "enum" ? `Unknown (${value})` : value;
+}
+function mapPath(value, path, vocabulary) {
+    if (!path.length)
+        return humanValue(vocabulary, value);
+    const [key, ...rest] = path;
+    if (key === "*")
+        return Array.isArray(value)
+            ? value.map((item) => mapPath(item, rest, vocabulary))
+            : value;
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        !Object.hasOwn(value, key))
+        return value;
+    const object = value;
+    return { ...object, [key]: mapPath(object[key], rest, vocabulary) };
+}
+/** A copy for human rendering only, after redaction. Arbitrary metadata is never traversed. */
+export function humanValueSemantics(command, result) {
+    return bindings(command).reduce((value, entry) => mapPath(value, entry.path.split("."), entry.vocabulary), result);
+}
+//# sourceMappingURL=value-semantics.js.map

package/dist/value-semantics.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,3 @@
+import { readFileSync } from "node:fs";
+export const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+//# sourceMappingURL=version.js.map