@spicetify/kit 0.4.0 → 0.4.1

package/dist/vault-metadata.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2026 Afonso Jorge Ramos
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+const KINDS = ["extension", "theme", "snippet", "app", "lib"];
+// A submission may declare `kind` or, if it predates the migration, the old
+// `tags` list; either way the vault records exactly one kind.
+export const kindOfMeta = (meta) => {
+    if (typeof meta.kind === "string" && KINDS.includes(meta.kind)) {
+        return meta.kind;
+    }
+    const tags = Array.isArray(meta.tags) ? meta.tags : [];
+    return KINDS.find((kind) => tags.includes(kind));
+};
+// metadata.json authors are plain names; author objects (with a github)
+// pass through, so an artifact may declare either.
+const normalizeAuthors = (authors) => authors.flatMap((a) => {
+    if (typeof a === "string")
+        return [{ name: a }];
+    if (a && typeof a === "object" && typeof a.name === "string") {
+        const { name, github } = a;
+        return [{ name, ...(typeof github === "string" ? { github } : {}) }];
+    }
+    return [];
+});
+export const metadataSubset = (meta) => {
+    const out = {};
+    if (typeof meta.name === "string")
+        out.name = meta.name;
+    if (typeof meta.description === "string")
+        out.description = meta.description;
+    if (Array.isArray(meta.authors))
+        out.authors = normalizeAuthors(meta.authors);
+    const kind = kindOfMeta(meta);
+    if (kind)
+        out.kind = kind;
+    // Previews inside the zip are not hotlinkable; only absolute URLs are
+    // useful to the store.
+    if (typeof meta.preview === "string" && /^https?:\/\//.test(meta.preview))
+        out.preview = meta.preview;
+    // Source and readme links only when absolute; the store refuses
+    // anything else anyway.
+    if (typeof meta.repository === "string" && meta.repository.startsWith("https://"))
+        out.repository = meta.repository;
+    if (typeof meta.readme === "string" && meta.readme.startsWith("https://"))
+        out.readme = meta.readme;
+    if (typeof meta.license === "string" && meta.license.trim())
+        out.license = meta.license.trim();
+    return out;
+};

package/dist/vault.js

@@ -5,43 +5,15 @@
 /**
  * vault - record a built module into a vault file for the module store.
  *
- * Card data (name, description, authors, tags) is embedded at the module
+ * Card data (name, description, authors, kind) is embedded at the module
  * level from the dist dir's own metadata.json so it cannot drift from what
  * installs, alongside a per-version sha256 checksum of the artifact.
  */
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
+import { metadataSubset } from "./vault-metadata.js";
 const USAGE = "spicetify-kit vault add <dist-dir> --artifact <url> [--zip <file>] [--vault <path>]\n  (default target: vault/<id>.json, the shape a store submission takes)";
-const normalizeAuthors = (authors) => authors.flatMap((a) => {
-    if (typeof a === "string")
-        return [{ name: a }];
-    if (a && typeof a === "object" && typeof a.name === "string") {
-        const { name, github } = a;
-        return [{ name, ...(typeof github === "string" ? { github } : {}) }];
-    }
-    return [];
-});
-const metadataSubset = (meta) => {
-    const out = {};
-    if (typeof meta.name === "string")
-        out.name = meta.name;
-    if (typeof meta.description === "string")
-        out.description = meta.description;
-    if (Array.isArray(meta.authors))
-        out.authors = normalizeAuthors(meta.authors);
-    if (Array.isArray(meta.tags))
-        out.tags = meta.tags;
-    if (typeof meta.preview === "string" && /^https?:\/\//.test(meta.preview))
-        out.preview = meta.preview;
-    if (typeof meta.repository === "string" && meta.repository.startsWith("https://"))
-        out.repository = meta.repository;
-    if (typeof meta.readme === "string" && meta.readme.startsWith("https://"))
-        out.readme = meta.readme;
-    if (typeof meta.license === "string" && meta.license.trim())
-        out.license = meta.license.trim();
-    return out;
-};
 const sha256 = (bytes) => `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
 const today = () => new Date().toISOString().slice(0, 10);
 async function download(url) {

package/dist/version.js

@@ -4,5 +4,5 @@
  */
 // Kept in lockstep with package.json by release-please. Scaffolds must depend
 // on the kit version that generated them, especially across pre-1.0 minors.
-export const KIT_VERSION = "0.4.0"; // x-release-please-version
+export const KIT_VERSION = "0.4.1"; // x-release-please-version
 export const KIT_DEPENDENCY_RANGE = `^${KIT_VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@spicetify/kit",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"description": "Developer kit for spicetify v3 modules: scaffold, build, hot-push, and pack",
 	"license": "GPL-3.0-or-later",
 	"homepage": "https://github.com/spicetify/modules#readme",