support isolated declarations

Author: macalinao

bun.lock

@@ -2,6 +2,11 @@ export { addressSchema } from "./address-schema.js";
 export { U8_MAX, U16_MAX, U32_MAX, U64_MAX } from "./constants.js";
 export {
   type TokenMetadata,
+  type TokenMetadataAttribute,
+  type TokenMetadataCollection,
+  type TokenMetadataCreator,
+  type TokenMetadataFile,
+  type TokenMetadataProperties,
   tokenMetadataSchema,
 } from "./token-metadata-schema.js";
 export { u8Schema } from "./u8-schema.js";

packages/zod-solana/src/index.ts

@@ -3,7 +3,7 @@ import * as z from "zod";
 /**
  * Schema for token metadata attributes
  */
-const tokenAttributeSchema = z.object({
+const tokenAttributeSchema: z.ZodType<TokenMetadataAttribute> = z.object({
   trait_type: z.string(),
   value: z.union([z.string(), z.number()]),
   display_type: z.string().optional(),
@@ -12,33 +12,124 @@ const tokenAttributeSchema = z.object({
 /**
  * Schema for token metadata files
  */
-const tokenFileSchema = z.object({
+const tokenFileSchema: z.ZodType<TokenMetadataFile> = z.object({
   uri: z.string(),
   type: z.string(),
   cdn: z.boolean().optional(),
 });
 
+/**
+ * Schema for token metadata creators
+ */
+const tokenCreatorSchema: z.ZodType<TokenMetadataCreator> = z.object({
+  address: z.string(),
+  share: z.number().min(0).max(100),
+});
+
 /**
  * Schema for token metadata properties
  */
-const tokenPropertiesSchema = z.object({
+const tokenPropertiesSchema: z.ZodType<TokenMetadataProperties> = z.object({
   files: z.array(tokenFileSchema).optional(),
   category: z.string().optional(),
-  creators: z
-    .array(
-      z.object({
-        address: z.string(),
-        share: z.number().min(0).max(100),
-      }),
-    )
-    .optional(),
+  creators: z.array(tokenCreatorSchema).optional(),
+});
+
+/**
+ * Schema for token metadata collection
+ */
+const tokenCollectionSchema: z.ZodType<TokenMetadataCollection> = z.object({
+  name: z.string(),
+  family: z.string().optional(),
 });
 
+/**
+ * Interface for token metadata attributes/traits
+ */
+export interface TokenMetadataAttribute {
+  /** The trait type/category */
+  trait_type: string;
+  /** The trait value (string or number) */
+  value: string | number;
+  /** Optional display type for UI formatting */
+  display_type?: string;
+}
+
+/**
+ * Interface for token metadata file references
+ */
+export interface TokenMetadataFile {
+  /** File URI */
+  uri: string;
+  /** File MIME type */
+  type: string;
+  /** Whether the file is CDN cached */
+  cdn?: boolean;
+}
+
+/**
+ * Interface for token creator information with royalty shares
+ */
+export interface TokenMetadataCreator {
+  /** Creator's wallet address */
+  address: string;
+  /** Creator's royalty share percentage (0-100) */
+  share: number;
+}
+
+/**
+ * Interface for token metadata properties
+ */
+export interface TokenMetadataProperties {
+  /** Optional array of file references */
+  files?: TokenMetadataFile[];
+  /** Optional category classification */
+  category?: string;
+  /** Optional array of creators with royalty shares */
+  creators?: TokenMetadataCreator[];
+}
+
+/**
+ * Interface for token collection information
+ */
+export interface TokenMetadataCollection {
+  /** Collection name */
+  name: string;
+  /** Optional collection family */
+  family?: string;
+}
+
+/**
+ * Interface for Solana token metadata following the Metaplex Token Metadata Standard
+ */
+export interface TokenMetadata {
+  /** The name of the token */
+  name: string;
+  /** The symbol of the token */
+  symbol: string;
+  /** Optional description of the token */
+  description?: string;
+  /** Optional image URI */
+  image?: string;
+  /** Optional animation URL for multimedia content */
+  animation_url?: string;
+  /** Optional external URL for additional information */
+  external_url?: string;
+  /** Optional array of attributes/traits */
+  attributes?: TokenMetadataAttribute[];
+  /** Optional properties object */
+  properties?: TokenMetadataProperties;
+  /** Optional seller fee basis points (royalty percentage * 100) */
+  seller_fee_basis_points?: number;
+  /** Optional collection information */
+  collection?: TokenMetadataCollection;
+}
+
 /**
  * Schema for Solana token metadata JSON
  * Based on Metaplex Token Metadata Standard
  */
-export const tokenMetadataSchema = z.object({
+export const tokenMetadataSchema: z.ZodType<TokenMetadata> = z.object({
   name: z.string(),
   symbol: z.string(),
   description: z.string().optional(),
@@ -49,12 +140,5 @@ export const tokenMetadataSchema = z.object({
   properties: tokenPropertiesSchema.optional(),
   // Additional fields that may be present
   seller_fee_basis_points: z.number().optional(),
-  collection: z
-    .object({
-      name: z.string(),
-      family: z.string().optional(),
-    })
-    .optional(),
+  collection: tokenCollectionSchema.optional(),
 });
-
-export type TokenMetadata = z.infer<typeof tokenMetadataSchema>;

packages/zod-solana/src/token-metadata-schema.ts

@@ -5,7 +5,7 @@ import { U16_MAX } from "./constants.js";
  * A Zod schema for u16 values.
  * Validates that a number is between 0 and 65535 (inclusive).
  */
-export const u16Schema = z
+export const u16Schema: z.ZodNumber = z
   .number()
   .int("Value must be an integer")
   .min(0, "Value must be at least 0")

packages/zod-solana/src/u16-schema.ts

@@ -5,7 +5,7 @@ import { U32_MAX } from "./constants.js";
  * A Zod schema for u32 values.
  * Validates that a number is between 0 and 4294967295 (inclusive).
  */
-export const u32Schema = z
+export const u32Schema: z.ZodNumber = z
   .number()
   .int("Value must be an integer")
   .min(0, "Value must be at least 0")

packages/zod-solana/src/u32-schema.ts

@@ -5,7 +5,7 @@ import { U64_MAX } from "./constants.js";
  * A Zod schema for u64 values.
  * Validates that a bigint is between 0 and 2^64-1 (inclusive).
  */
-export const u64Schema = z
+export const u64Schema: z.ZodBigInt = z
   .bigint()
   .min(0n, "Value must be at least 0")
   .max(U64_MAX, `Value must be at most ${String(U64_MAX)}`);

packages/zod-solana/src/u64-schema.ts

@@ -6,7 +6,7 @@ import { U64_MAX } from "./constants.js";
  * Validates that a string represents a valid u64 value (0 to 2^64-1).
  * Returns the value as a string to preserve precision for large numbers.
  */
-export const u64StringSchema = z.string().refine(
+export const u64StringSchema: z.ZodType<string> = z.string().refine(
   (val) => {
     // Check for empty string
     if (val === "") {

packages/zod-solana/src/u64-string-schema.ts

@@ -5,7 +5,7 @@ import { U8_MAX } from "./constants.js";
  * A Zod schema for u8 values.
  * Validates that a number is between 0 and 255 (inclusive).
  */
-export const u8Schema = z
+export const u8Schema: z.ZodNumber = z
   .number()
   .int("Value must be an integer")
   .min(0, "Value must be at least 0")

packages/zod-solana/src/u8-schema.ts

@@ -5,15 +5,15 @@ import { u8Schema } from "./u8-schema.js";
  * A Zod schema for Uint8Array.
  * Accepts an array of numbers and transforms it to a Uint8Array.
  */
-export const uint8ArraySchema = z
+export const uint8ArraySchema: z.ZodType<Uint8Array> = z
   .array(u8Schema)
   .transform((arr) => new Uint8Array(arr));
 
 /**
  * A Zod schema for JSON-encoded Uint8Array.
  * Accepts a JSON string, parses it, and transforms to Uint8Array.
  */
-export const jsonUint8ArraySchema = z
+export const jsonUint8ArraySchema: z.ZodType<Uint8Array> = z
   .string()
   .transform((str) => {
     try {

packages/zod-solana/src/uint8array-schema.ts

@@ -1,7 +1,6 @@
 {
-  "extends": "@macalinao/tsconfig/tsconfig.dom.json",
+  "extends": "@macalinao/tsconfig/tsconfig.base.json",
   "compilerOptions": {
-    "types": ["bun"],
-    "isolatedDeclarations": false
+    "types": ["bun"]
   }
 }