@agentrules/core 0.0.3 → 0.0.4

package/dist/index.d.ts

@@ -1,7 +1,20 @@
 import { z } from "zod";
 
-//#region src/types/platform.d.ts
+//#region src/types/constants.d.ts
+/**
+* Shared constants for agentrules presets and registry.
+*/
+/** Filename for preset configuration */
+/**
+ * Shared constants for agentrules presets and registry.
+ */
+/** Filename for preset configuration */
+declare const PRESET_CONFIG_FILENAME = "agentrules.json";
+/** JSON Schema URL for preset configuration */
+declare const PRESET_SCHEMA_URL = "https://agentrules.directory/schema/agentrules.json";
 
+//#endregion
+//#region src/types/platform.d.ts
 /**
  * Single source of truth for platform IDs.
  * Add new platforms here - types and config will follow.
@@ -29,6 +42,7 @@ declare const PLATFORMS: Record<PlatformId, PlatformConfig>;
 declare const CONFIG_DIR_NAME = "config";
 declare function isSupportedPlatform(value: string): value is PlatformId;
 declare function normalizePlatformInput(value: string): PlatformId;
+
 //#endregion
 //#region src/types/definitions.d.ts
 type AuthorInfo = {
@@ -37,7 +51,8 @@ type AuthorInfo = {
   url?: string;
 };
 type PlatformPresetConfig = {
-  path: string;
+  /** Path to platform config files. Defaults to platform's projectDir (e.g., ".opencode") */
+  path?: string;
   features?: string[];
   installMessage?: string;
 };
@@ -45,11 +60,11 @@ type PresetConfig = {
   $schema?: string;
   name: string;
   title: string;
-  version: string;
+  version?: string;
   description: string;
   tags?: string[];
   author?: AuthorInfo;
-  license?: string;
+  license: string;
   platforms: Partial<Record<PlatformId, PlatformPresetConfig>>;
 };
 type BundledFile = {
@@ -67,10 +82,11 @@ type RegistryBundle = {
   description: string;
   tags: string[];
   author?: AuthorInfo;
-  license?: string;
+  license: string;
+  licenseContent?: string;
+  readmeContent?: string;
   features?: string[];
   installMessage?: string;
-  readme?: string;
   files: BundledFile[];
 };
 type RegistryEntry = {
@@ -82,15 +98,17 @@ type RegistryEntry = {
   description: string;
   tags: string[];
   author?: AuthorInfo;
-  license?: string;
+  license: string;
   features?: string[];
   installMessage?: string;
   bundlePath: string;
   fileCount: number;
   /** Total size of all files in bytes */
   totalSize: number;
-  /** Whether the preset has a README */
-  hasReadme?: boolean;
+  /** Whether the preset has a README.md */
+  hasReadmeContent?: boolean;
+  /** Whether the preset has a LICENSE.md */
+  hasLicenseContent?: boolean;
 };
 type RegistryData = {
   $schema: string;
@@ -105,12 +123,15 @@ type RegistryFileInput = {
 type RegistryPlatformInput = {
   platform: PlatformId;
   files: RegistryFileInput[];
+  /** Install message from INSTALL.txt file */
+  installMessage?: string;
 };
 type RegistryPresetInput = {
   slug: string;
   config: PresetConfig;
   platforms: RegistryPlatformInput[];
-  readme?: string;
+  readmeContent?: string;
+  licenseContent?: string;
 }; //#endregion
 //#region src/types/schema.d.ts
 declare const platformIdSchema: z.ZodEnum<{
@@ -124,16 +145,29 @@ declare const authorSchema: z.ZodObject<{
   email: z.ZodOptional<z.ZodEmail>;
   url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
+declare const titleSchema: z.ZodString;
+declare const descriptionSchema: z.ZodString;
+/** Validate a title string and return error message if invalid, undefined if valid */
+declare function validateTitle(value: string): string | undefined;
+/** Validate a description string and return error message if invalid, undefined if valid */
+declare function validateDescription(value: string): string | undefined;
+declare const slugSchema: z.ZodString;
+/** Validate a slug string and return error message if invalid, undefined if valid */
+declare function validateSlug(value: string): string | undefined;
+declare const COMMON_LICENSES: readonly ["MIT", "Apache-2.0", "GPL-3.0-only", "BSD-3-Clause", "ISC", "Unlicense"];
+type CommonLicense = (typeof COMMON_LICENSES)[number];
+declare const licenseSchema: z.ZodString;
+/** Validate a license string and return error message if invalid, undefined if valid */
+declare function validateLicense(value: string): string | undefined;
 declare const platformPresetConfigSchema: z.ZodObject<{
-  path: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
   features: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  installMessage: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 declare const presetConfigSchema: z.ZodObject<{
   $schema: z.ZodOptional<z.ZodString>;
   name: z.ZodString;
   title: z.ZodString;
-  version: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
   description: z.ZodString;
   tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   author: z.ZodOptional<z.ZodObject<{
@@ -141,12 +175,11 @@ declare const presetConfigSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodEmail>;
     url: z.ZodOptional<z.ZodURL>;
   }, z.core.$strict>>;
-  license: z.ZodOptional<z.ZodString>;
+  license: z.ZodString;
   platforms: z.ZodObject<{
     [x: string]: z.ZodOptional<z.ZodObject<{
-      path: z.ZodString;
+      path: z.ZodOptional<z.ZodString>;
       features: z.ZodOptional<z.ZodArray<z.ZodString>>;
-      installMessage: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
   }, z.core.$strip>;
 }, z.core.$strict>;
@@ -173,7 +206,9 @@ declare const registryBundleSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodEmail>;
     url: z.ZodOptional<z.ZodURL>;
   }, z.core.$strict>>;
-  license: z.ZodOptional<z.ZodString>;
+  license: z.ZodString;
+  licenseContent: z.ZodOptional<z.ZodString>;
+  readmeContent: z.ZodOptional<z.ZodString>;
   features: z.ZodOptional<z.ZodArray<z.ZodString>>;
   installMessage: z.ZodOptional<z.ZodString>;
   files: z.ZodArray<z.ZodObject<{
@@ -185,17 +220,16 @@ declare const registryBundleSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const registryEntrySchema: z.ZodObject<{
   features: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  installMessage: z.ZodOptional<z.ZodString>;
   title: z.ZodString;
-  version: z.ZodString;
   description: z.ZodString;
+  license: z.ZodString;
+  version: z.ZodString;
   tags: z.ZodArray<z.ZodString>;
   author: z.ZodOptional<z.ZodObject<{
     name: z.ZodString;
     email: z.ZodOptional<z.ZodEmail>;
     url: z.ZodOptional<z.ZodURL>;
   }, z.core.$strict>>;
-  license: z.ZodOptional<z.ZodString>;
   platform: z.ZodEnum<{
     opencode: "opencode";
     codex: "codex";
@@ -207,20 +241,21 @@ declare const registryEntrySchema: z.ZodObject<{
   bundlePath: z.ZodString;
   fileCount: z.ZodNumber;
   totalSize: z.ZodNumber;
+  hasReadmeContent: z.ZodOptional<z.ZodBoolean>;
+  hasLicenseContent: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const registryIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
   features: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  installMessage: z.ZodOptional<z.ZodString>;
   title: z.ZodString;
-  version: z.ZodString;
   description: z.ZodString;
+  license: z.ZodString;
+  version: z.ZodString;
   tags: z.ZodArray<z.ZodString>;
   author: z.ZodOptional<z.ZodObject<{
     name: z.ZodString;
     email: z.ZodOptional<z.ZodEmail>;
     url: z.ZodOptional<z.ZodURL>;
   }, z.core.$strict>>;
-  license: z.ZodOptional<z.ZodString>;
   platform: z.ZodEnum<{
     opencode: "opencode";
     codex: "codex";
@@ -232,6 +267,8 @@ declare const registryIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
   bundlePath: z.ZodString;
   fileCount: z.ZodNumber;
   totalSize: z.ZodNumber;
+  hasReadmeContent: z.ZodOptional<z.ZodBoolean>;
+  hasLicenseContent: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 
 //#endregion
@@ -239,6 +276,8 @@ declare const registryIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
 type BuildRegistryDataOptions = {
   presets: RegistryPresetInput[];
   bundleBase?: string;
+  /** Override the auto-generated version. If not provided, uses current UTC date. */
+  version?: string;
 };
 type BuildRegistryDataResult = {
   entries: RegistryEntry[];
@@ -249,6 +288,11 @@ declare function buildRegistryData(options: BuildRegistryDataOptions): BuildRegi
 
 //#endregion
 //#region src/builder/utils.d.ts
+/**
+ * Generates a date-based version string in format YYYY.MM.DD
+ * Uses UTC to ensure consistent versioning across timezones
+ */
+declare function generateDateVersion(date?: Date): string;
 declare function normalizeBundlePublicBase(value: string): string;
 declare function isAbsoluteUrl(value: string): boolean;
 declare function cleanInstallMessage(value: unknown): string | undefined;
@@ -265,12 +309,8 @@ declare function toUtf8String(payload: ArrayBuffer | ArrayBufferView): string;
 
 //#endregion
 //#region src/client/registry.d.ts
-type FetchRegistryBundleResult = {
-  bundle: RegistryBundle;
-  etag: string | null;
-};
 declare function fetchRegistryIndex(baseUrl: string): Promise<RegistryIndex>;
-declare function fetchRegistryBundle(baseUrl: string, bundlePath: string): Promise<FetchRegistryBundleResult>;
+declare function fetchRegistryBundle(baseUrl: string, bundlePath: string): Promise<RegistryBundle>;
 declare function resolveRegistryEntry(index: RegistryIndex, input: string, explicitPlatform?: PlatformId): RegistryEntry;
 
 //#endregion
@@ -295,4 +335,4 @@ declare function normalizePathFragment(value?: string): string | undefined;
 declare function maybeStripPrefix(pathInput: string, prefix?: string): string;
 
 //#endregion
-export { AuthorInfo, BuildRegistryDataOptions, BuildRegistryDataResult, BundledFile, CONFIG_DIR_NAME, DiffPreviewOptions, FetchRegistryBundleResult, PLATFORMS, PLATFORM_IDS, PlatformId, PlatformPresetConfig, PresetConfig, RegistryBundle, RegistryData, RegistryEntry, RegistryFileInput, RegistryIndex, RegistryIndexItem, RegistryPlatformInput, RegistryPresetInput, authorSchema, buildRegistryData, bundledFileSchema, cleanInstallMessage, collectBundledFiles, createDiffPreview, decodeBundledFile, decodeUtf8, encodeItemName, encodeUtf8, fetchRegistryBundle, fetchRegistryIndex, isAbsoluteUrl, isLikelyText, isSupportedPlatform, maybeStripPrefix, normalizeBundlePath, normalizeBundlePublicBase, normalizePathFragment, normalizePlatformInput, platformIdSchema, platformPresetConfigSchema, presetConfigSchema, registryBundleSchema, registryEntrySchema, registryIndexSchema, resolveRegistryEntry, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };
+export { AuthorInfo, BuildRegistryDataOptions, BuildRegistryDataResult, BundledFile, COMMON_LICENSES, CONFIG_DIR_NAME, CommonLicense, DiffPreviewOptions, PLATFORMS, PLATFORM_IDS, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, PlatformId, PlatformPresetConfig, PresetConfig, RegistryBundle, RegistryData, RegistryEntry, RegistryFileInput, RegistryIndex, RegistryIndexItem, RegistryPlatformInput, RegistryPresetInput, authorSchema, buildRegistryData, bundledFileSchema, cleanInstallMessage, collectBundledFiles, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchRegistryBundle, fetchRegistryIndex, generateDateVersion, isAbsoluteUrl, isLikelyText, isSupportedPlatform, licenseSchema, maybeStripPrefix, normalizeBundlePath, normalizeBundlePublicBase, normalizePathFragment, normalizePlatformInput, platformIdSchema, platformPresetConfigSchema, presetConfigSchema, registryBundleSchema, registryEntrySchema, registryIndexSchema, resolveRegistryEntry, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validateDescription, validateLicense, validatePresetConfig, validateSlug, validateTitle, verifyBundledFileChecksum };

package/dist/index.js

@@ -2,6 +2,16 @@ import { createHash } from "crypto";
 import { z } from "zod";
 import { createTwoFilesPatch } from "diff";
 
+//#region src/types/constants.ts
+/**
+* Shared constants for agentrules presets and registry.
+*/
+/** Filename for preset configuration */
+const PRESET_CONFIG_FILENAME = "agentrules.json";
+/** JSON Schema URL for preset configuration */
+const PRESET_SCHEMA_URL = "https://agentrules.directory/schema/agentrules.json";
+
+//#endregion
 //#region src/types/platform.ts
 /**
 * Single source of truth for platform IDs.
@@ -53,7 +63,7 @@ function normalizePlatformInput(value) {
 
 //#endregion
 //#region src/types/schema.ts
-const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:0|[1-9A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+const DATE_VERSION_REGEX = /^\d{4}\.(0[1-9]|1[0-2])\.(0[1-9]|[12]\d|3[01])(-\d+)?$/;
 const platformIdSchema = z.enum(PLATFORM_IDS);
 const authorSchema = z.object({
 	name: z.string().trim().min(1),
@@ -62,30 +72,69 @@ const authorSchema = z.object({
 }).strict();
 const titleSchema = z.string().trim().min(1).max(120);
 const descriptionSchema = z.string().trim().min(1).max(500);
-const versionSchema = z.string().trim().regex(SEMVER_REGEX, "Version must follow semantic versioning");
+/** Validate a title string and return error message if invalid, undefined if valid */
+function validateTitle(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "Title is required";
+	if (trimmed.length > 120) return "Title must be 120 characters or less";
+	return;
+}
+/** Validate a description string and return error message if invalid, undefined if valid */
+function validateDescription(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "Description is required";
+	if (trimmed.length > 500) return "Description must be 500 characters or less";
+	return;
+}
+const versionSchema = z.string().trim().regex(DATE_VERSION_REGEX, "Version must be date-based (YYYY.MM.DD or YYYY.MM.DD-N)");
 const tagSchema = z.string().trim().min(1).max(48);
 const tagsSchema = z.array(tagSchema).max(10);
 const featureSchema = z.string().trim().min(1).max(160);
 const featuresSchema = z.array(featureSchema).max(10);
 const installMessageSchema = z.string().trim().max(4e3);
-const licenseSchema = z.string().trim().max(80);
-const slugSchema = z.string().trim().min(1).max(64).regex(/^[a-z0-9-]+$/, "Name must be lowercase kebab-case");
+const contentSchema = z.string();
+const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const SLUG_ERROR = "Must be lowercase alphanumeric with hyphens (e.g., my-preset)";
+const slugSchema = z.string().trim().min(1).max(64).regex(SLUG_REGEX, SLUG_ERROR);
+/** Validate a slug string and return error message if invalid, undefined if valid */
+function validateSlug(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "Name is required";
+	if (trimmed.length > 64) return "Name must be 64 characters or less";
+	if (!SLUG_REGEX.test(trimmed)) return SLUG_ERROR;
+	return;
+}
+const COMMON_LICENSES = [
+	"MIT",
+	"Apache-2.0",
+	"GPL-3.0-only",
+	"BSD-3-Clause",
+	"ISC",
+	"Unlicense"
+];
+const licenseSchema = z.string().trim().min(1).max(128);
+/** Validate a license string and return error message if invalid, undefined if valid */
+function validateLicense(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "License is required";
+	if (trimmed.length > 128) return "License must be 128 characters or less";
+	return;
+}
 const pathSchema = z.string().trim().min(1);
 const platformPresetConfigSchema = z.object({
-	path: pathSchema,
-	features: featuresSchema.optional(),
-	installMessage: installMessageSchema.optional()
+	path: pathSchema.optional(),
+	features: featuresSchema.optional()
 }).strict();
 const platformsObjectSchema = z.object(Object.fromEntries(PLATFORM_IDS.map((id) => [id, platformPresetConfigSchema.optional()]))).refine((p) => Object.keys(p).length > 0, { message: "At least one platform must be configured" });
 const presetConfigSchema = z.object({
 	$schema: z.string().optional(),
 	name: slugSchema,
 	title: titleSchema,
-	version: versionSchema,
+	version: versionSchema.optional(),
 	description: descriptionSchema,
 	tags: tagsSchema.optional(),
 	author: authorSchema.optional(),
-	license: licenseSchema.optional(),
+	license: licenseSchema,
 	platforms: platformsObjectSchema
 }).strict();
 const bundledFileSchema = z.object({
@@ -102,16 +151,25 @@ const registryBundleSchema = z.object({
 	description: descriptionSchema,
 	tags: tagsSchema,
 	author: authorSchema.optional(),
-	license: licenseSchema.optional(),
+	license: licenseSchema,
+	licenseContent: contentSchema.optional(),
+	readmeContent: contentSchema.optional(),
 	features: featuresSchema.optional(),
 	installMessage: installMessageSchema.optional(),
 	files: z.array(bundledFileSchema).min(1)
 });
-const registryEntrySchema = registryBundleSchema.omit({ files: true }).extend({
+const registryEntrySchema = registryBundleSchema.omit({
+	files: true,
+	readmeContent: true,
+	licenseContent: true,
+	installMessage: true
+}).extend({
 	name: z.string().trim().min(1),
 	bundlePath: z.string().trim().min(1),
 	fileCount: z.number().int().nonnegative(),
-	totalSize: z.number().int().nonnegative()
+	totalSize: z.number().int().nonnegative(),
+	hasReadmeContent: z.boolean().optional(),
+	hasLicenseContent: z.boolean().optional()
 });
 const registryIndexSchema = z.record(z.string(), registryEntrySchema);
 
@@ -137,6 +195,16 @@ function toUint8Array(payload) {
 
 //#endregion
 //#region src/builder/utils.ts
+/**
+* Generates a date-based version string in format YYYY.MM.DD
+* Uses UTC to ensure consistent versioning across timezones
+*/
+function generateDateVersion(date = new Date()) {
+	const year = date.getUTCFullYear();
+	const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+	const day = String(date.getUTCDate()).padStart(2, "0");
+	return `${year}.${month}.${day}`;
+}
 function normalizeBundlePublicBase(value) {
 	const trimmed = value.trim();
 	if (!trimmed) throw new Error("--bundle-base must be a non-empty string");
@@ -162,8 +230,9 @@ function validatePresetConfig(config, slug) {
 	const preset = config;
 	if (!preset.name || typeof preset.name !== "string") throw new Error(`Preset ${slug} is missing a name`);
 	if (!preset.title || typeof preset.title !== "string") throw new Error(`Preset ${slug} is missing a title`);
-	if (!preset.version || typeof preset.version !== "string") throw new Error(`Preset ${slug} is missing a version`);
+	if (preset.version !== void 0 && typeof preset.version !== "string") throw new Error(`Preset ${slug} has invalid version (must be string or omitted)`);
 	if (!preset.description || typeof preset.description !== "string") throw new Error(`Preset ${slug} is missing a description`);
+	if (!preset.license || typeof preset.license !== "string") throw new Error(`Preset ${slug} is missing a license (SPDX identifier required)`);
 	if (!preset.platforms || typeof preset.platforms !== "object") throw new Error(`Preset ${slug} is missing platforms map`);
 	return preset;
 }
@@ -185,6 +254,7 @@ function collectBundledFiles(files) {
 const NAME_PATTERN = /^[a-z0-9-]+$/;
 function buildRegistryData(options) {
 	const bundleBase = normalizeBundlePublicBase(options.bundleBase ?? "/r");
+	const buildVersion = options.version ?? generateDateVersion();
 	const entries = [];
 	const bundles = [];
 	for (const presetInput of options.presets) {
@@ -199,38 +269,40 @@ function buildRegistryData(options) {
 			if (platformInput.files.length === 0) throw new Error(`Preset ${presetInput.slug}/${platform} does not include any files.`);
 			const files = createBundledFilesFromInputs(platformInput.files);
 			const totalSize = files.reduce((sum, file) => sum + file.size, 0);
-			const installMessage = cleanInstallMessage(platformConfig.installMessage);
+			const installMessage = cleanInstallMessage(platformInput.installMessage);
 			const features = platformConfig.features ?? [];
-			const readme = presetInput.readme?.trim() || void 0;
+			const readmeContent = presetInput.readmeContent?.trim() || void 0;
+			const licenseContent = presetInput.licenseContent?.trim() || void 0;
 			const entry = {
 				name: encodeItemName(presetInput.slug, platform),
 				slug: presetInput.slug,
 				platform,
 				title: presetConfig.title,
-				version: presetConfig.version,
+				version: buildVersion,
 				description: presetConfig.description,
 				tags: presetConfig.tags ?? [],
 				author: presetConfig.author,
 				license: presetConfig.license,
 				features,
-				installMessage,
-				bundlePath: getBundlePublicPath(bundleBase, presetInput.slug, platform),
+				bundlePath: getBundlePublicPath(bundleBase, presetInput.slug, platform, buildVersion),
 				fileCount: files.length,
 				totalSize,
-				hasReadme: Boolean(readme)
+				hasReadmeContent: Boolean(readmeContent),
+				hasLicenseContent: Boolean(licenseContent)
 			};
 			const bundle = {
 				slug: presetInput.slug,
 				platform,
 				title: presetConfig.title,
-				version: presetConfig.version,
+				version: buildVersion,
 				description: presetConfig.description,
 				tags: presetConfig.tags ?? [],
 				author: presetConfig.author,
 				license: presetConfig.license,
+				licenseContent,
+				readmeContent,
 				features,
 				installMessage,
-				readme,
 				files
 			};
 			entries.push(entry);
@@ -273,9 +345,9 @@ function encodeFilePayload(buffer, filePath) {
 	if (!Buffer.from(utf8, "utf8").equals(buffer)) throw new Error(`Binary files are not supported: "${filePath}". Only UTF-8 text files are allowed.`);
 	return utf8;
 }
-function getBundlePublicPath(base, slug, platform) {
+function getBundlePublicPath(base, slug, platform, version) {
 	const prefix = base === "/" ? "" : base;
-	return `${prefix}/${slug}/${platform}.json`;
+	return `${prefix}/${slug}/${platform}.${version}.json`;
 }
 function ensureKnownPlatform(platform, slug) {
 	if (!isSupportedPlatform(platform)) throw new Error(`Unknown platform "${platform}" in ${slug}. Supported: ${PLATFORM_IDS.join(", ")}`);
@@ -334,11 +406,7 @@ async function fetchRegistryBundle(baseUrl, bundlePath) {
 	const response = await fetch(bundleUrl);
 	if (!response.ok) throw new Error(`Failed to download bundle (${response.status} ${response.statusText}).`);
 	try {
-		const bundle = await response.json();
-		return {
-			bundle,
-			etag: response.headers.get("etag")
-		};
+		return await response.json();
 	} catch (error) {
 		throw new Error(`Unable to parse bundle JSON: ${error.message}`);
 	}
@@ -404,4 +472,4 @@ function maybeStripPrefix(pathInput, prefix) {
 }
 
 //#endregion
-export { CONFIG_DIR_NAME, PLATFORMS, PLATFORM_IDS, authorSchema, buildRegistryData, bundledFileSchema, cleanInstallMessage, collectBundledFiles, createDiffPreview, decodeBundledFile, decodeUtf8, encodeItemName, encodeUtf8, fetchRegistryBundle, fetchRegistryIndex, isAbsoluteUrl, isLikelyText, isSupportedPlatform, maybeStripPrefix, normalizeBundlePath, normalizeBundlePublicBase, normalizePathFragment, normalizePlatformInput, platformIdSchema, platformPresetConfigSchema, presetConfigSchema, registryBundleSchema, registryEntrySchema, registryIndexSchema, resolveRegistryEntry, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };
+export { COMMON_LICENSES, CONFIG_DIR_NAME, PLATFORMS, PLATFORM_IDS, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, authorSchema, buildRegistryData, bundledFileSchema, cleanInstallMessage, collectBundledFiles, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchRegistryBundle, fetchRegistryIndex, generateDateVersion, isAbsoluteUrl, isLikelyText, isSupportedPlatform, licenseSchema, maybeStripPrefix, normalizeBundlePath, normalizeBundlePublicBase, normalizePathFragment, normalizePlatformInput, platformIdSchema, platformPresetConfigSchema, presetConfigSchema, registryBundleSchema, registryEntrySchema, registryIndexSchema, resolveRegistryEntry, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validateDescription, validateLicense, validatePresetConfig, validateSlug, validateTitle, verifyBundledFileChecksum };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrules/core",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "author": "Brian Cheung <bcheung.dev@gmail.com> (https://github.com/bcheung)",
   "license": "MIT",
   "homepage": "https://docs.agentrules.directory",
@@ -51,4 +51,4 @@
     "tsdown": "^0.9.0",
     "typescript": "5.7.2"
   }
-}
+}