@thyme-sh/sdk 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -1,87 +1,82 @@
 import { z } from 'zod';
 import { PublicClient, Address, Hex } from 'viem';
 
-/**
- * Context provided to task execution
- */
-interface ThymeContext<TArgs> {
-    /** User-provided arguments validated against schema */
-    args: TArgs;
-    /** Viem public client for reading blockchain data */
-    client: PublicClient;
+interface CompressResult {
+    zipBuffer: Uint8Array;
+    checksum: string;
 }
-/**
- * A call to be executed on-chain
- */
-interface Call {
-    /** Target contract address */
-    to: Address;
-    /** Encoded function call data */
-    data: Hex;
+interface DecompressResult {
+    source: string;
+    bundle: string;
 }
 /**
- * Result when task determines execution should proceed
+ * Compress source and bundle into a ZIP archive
+ * Uses fflate for fast, modern compression
+ * Uses SHA-256 for cryptographically secure checksum
  */
-interface SuccessResult {
-    canExec: true;
-    /** Array of calls to execute on-chain */
-    calls: Call[];
-}
+declare function compressTask(source: string, bundle: string): CompressResult;
 /**
- * Result when task determines execution should not proceed
+ * Decompress ZIP archive and extract source and bundle files
+ * Uses fflate for fast decompression
+ * Includes ZIP bomb protection
  */
-interface FailResult {
-    canExec: false;
-    /** Reason why execution should not proceed */
-    message: string;
-}
+declare function decompressTask(zipBuffer: Uint8Array | ArrayBuffer): DecompressResult;
+
 /**
- * Result returned from task execution
+ * Log entry with type and message
  */
-type TaskResult = SuccessResult | FailResult;
-/**
- * Task definition with schema and execution logic
- */
-interface TaskDefinition<TSchema extends z.ZodType> {
-    /** Zod schema for validating task arguments */
-    schema: TSchema;
-    /** Main execution function */
-    run: (ctx: ThymeContext<z.infer<TSchema>>) => Promise<TaskResult>;
+interface LogEntry {
+    type: 'info' | 'warn' | 'error';
+    message: string;
 }
-
 /**
- * Define a Web3 automation task
+ * Logger for Thyme tasks
+ *
+ * Use this logger to output messages that will be captured and displayed
+ * in the Thyme dashboard. Regular console.log calls will not be captured.
  *
  * @example
  * ```typescript
- * import { defineTask, z } from '@thyme-sh/sdk'
- * import { encodeFunctionData } from 'viem'
- *
- * const abi = [
- *   'function transfer(address to, uint256 amount) returns (bool)',
- * ] as const
- *
  * export default defineTask({
- *   schema: z.object({
- *     targetAddress: z.address(),
- *   }),
+ *   schema: z.object({ ... }),
  *   async run(ctx) {
- *     return {
- *       canExec: true,
- *       calls: [{
- *         to: ctx.args.targetAddress,
- *         data: encodeFunctionData({
- *           abi,
- *           functionName: 'transfer',
- *           args: [recipientAddress, 1000n],
- *         }),
- *       }]
- *     }
+ *     ctx.logger.info('Starting task execution')
+ *     ctx.logger.warn('Low balance detected')
+ *     ctx.logger.error('Failed to fetch price')
+ *     return { canExec: false, message: 'Error occurred' }
  *   }
  * })
  * ```
  */
-declare function defineTask<TSchema extends z.ZodType>(definition: TaskDefinition<TSchema>): TaskDefinition<TSchema>;
+declare class Logger {
+    private logs;
+    private static readonly LOG_PREFIX;
+    /**
+     * Log an info message
+     */
+    info(message: string): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string): void;
+    /**
+     * Log an error message
+     */
+    error(message: string): void;
+    private log;
+    /**
+     * Get all collected logs
+     */
+    getLogs(): LogEntry[];
+    /**
+     * Clear all collected logs
+     */
+    clear(): void;
+}
+/**
+ * Create a new logger instance
+ */
+declare function createLogger(): Logger;
 
 /**
  * Extended Zod with Ethereum address validation
@@ -288,23 +283,88 @@ declare const zodExtended: {
  */
 type InferSchema<T extends z.ZodType> = z.infer<T>;
 
-interface CompressResult {
-    zipBuffer: Uint8Array;
-    checksum: string;
+/**
+ * Context provided to task execution
+ */
+interface ThymeContext<TArgs> {
+    /** User-provided arguments validated against schema */
+    args: TArgs;
+    /** Viem public client for reading blockchain data */
+    client: PublicClient;
+    /** Logger for outputting messages to the Thyme dashboard */
+    logger: Logger;
 }
-interface DecompressResult {
-    source: string;
-    bundle: string;
+/**
+ * A call to be executed on-chain
+ */
+interface Call {
+    /** Target contract address */
+    to: Address;
+    /** Encoded function call data */
+    data: Hex;
 }
 /**
- * Compress source and bundle into a ZIP archive
- * Uses fflate for fast, modern compression
+ * Result when task determines execution should proceed
  */
-declare function compressTask(source: string, bundle: string): CompressResult;
+interface SuccessResult {
+    canExec: true;
+    /** Array of calls to execute on-chain */
+    calls: Call[];
+}
 /**
- * Decompress ZIP archive and extract source and bundle files
- * Uses fflate for fast decompression
+ * Result when task determines execution should not proceed
  */
-declare function decompressTask(zipBuffer: Uint8Array | ArrayBuffer): DecompressResult;
+interface FailResult {
+    canExec: false;
+    /** Reason why execution should not proceed */
+    message: string;
+}
+/**
+ * Result returned from task execution
+ */
+type TaskResult = SuccessResult | FailResult;
+/**
+ * Task definition with schema and execution logic
+ */
+interface TaskDefinition<TSchema extends z.ZodType> {
+    /** Zod schema for validating task arguments */
+    schema: TSchema;
+    /** Main execution function */
+    run: (ctx: ThymeContext<z.infer<TSchema>>) => Promise<TaskResult>;
+}
+
+/**
+ * Define a Web3 automation task
+ *
+ * @example
+ * ```typescript
+ * import { defineTask, z } from '@thyme-sh/sdk'
+ * import { encodeFunctionData } from 'viem'
+ *
+ * const abi = [
+ *   'function transfer(address to, uint256 amount) returns (bool)',
+ * ] as const
+ *
+ * export default defineTask({
+ *   schema: z.object({
+ *     targetAddress: z.address(),
+ *   }),
+ *   async run(ctx) {
+ *     return {
+ *       canExec: true,
+ *       calls: [{
+ *         to: ctx.args.targetAddress,
+ *         data: encodeFunctionData({
+ *           abi,
+ *           functionName: 'transfer',
+ *           args: [recipientAddress, 1000n],
+ *         }),
+ *       }]
+ *     }
+ *   }
+ * })
+ * ```
+ */
+declare function defineTask<TSchema extends z.ZodType>(definition: TaskDefinition<TSchema>): TaskDefinition<TSchema>;
 
-export { type Call, type CompressResult, type DecompressResult, type FailResult, type InferSchema, type SuccessResult, type TaskDefinition, type TaskResult, type ThymeContext, compressTask, decompressTask, defineTask, zodExtended as z };
+export { type Call, type CompressResult, type DecompressResult, type FailResult, type InferSchema, type LogEntry, Logger, type SuccessResult, type TaskDefinition, type TaskResult, type ThymeContext, compressTask, createLogger, decompressTask, defineTask, zodExtended as z };

package/dist/index.js

@@ -1,33 +1,11 @@
-// src/task.ts
-function defineTask(definition) {
-  return definition;
-}
-
-// src/schema.ts
-import { getAddress, isAddress } from "viem";
-import { z } from "zod";
-var zodExtended = {
-  ...z,
-  /**
-   * Validates an Ethereum address and returns viem's Address type
-   * Accepts both checksummed and non-checksummed addresses
-   *
-   * @example
-   * ```typescript
-   * import { zodExtended as z } from '@thyme-sh/sdk'
-   *
-   * const schema = z.object({
-   *   targetAddress: z.address(),
-   * })
-   * ```
-   */
-  address: () => z.string().refine((val) => isAddress(val), {
-    message: "Invalid Ethereum address"
-  }).transform((val) => getAddress(val))
-};
-
 // src/archive.ts
+import { createHash } from "crypto";
 import { strFromU8, strToU8, unzipSync, zipSync } from "fflate";
+var MAX_ZIP_SIZE = 10 * 1024 * 1024;
+var MAX_DECOMPRESSED_SIZE = 50 * 1024 * 1024;
+function calculateSha256(data) {
+  return createHash("sha256").update(data).digest("hex");
+}
 function compressTask(source, bundle) {
   const files = {
     "source.ts": strToU8(source),
@@ -37,15 +15,7 @@ function compressTask(source, bundle) {
     level: 6
     // Balanced compression
   });
-  let hash = 0;
-  for (let i = 0; i < compressed.length; i++) {
-    const byte = compressed[i];
-    if (byte !== void 0) {
-      hash = (hash << 5) - hash + byte;
-      hash = hash & hash;
-    }
-  }
-  const checksum = Math.abs(hash).toString(16);
+  const checksum = calculateSha256(compressed);
   return {
     zipBuffer: compressed,
     checksum
@@ -53,7 +23,24 @@ function compressTask(source, bundle) {
 }
 function decompressTask(zipBuffer) {
   const uint8Array = zipBuffer instanceof ArrayBuffer ? new Uint8Array(zipBuffer) : zipBuffer;
+  if (uint8Array.length > MAX_ZIP_SIZE) {
+    throw new Error(
+      `ZIP file too large: ${uint8Array.length} bytes (max: ${MAX_ZIP_SIZE})`
+    );
+  }
   const decompressed = unzipSync(uint8Array);
+  let totalDecompressedSize = 0;
+  for (const key of Object.keys(decompressed)) {
+    const file = decompressed[key];
+    if (file) {
+      totalDecompressedSize += file.length;
+    }
+  }
+  if (totalDecompressedSize > MAX_DECOMPRESSED_SIZE) {
+    throw new Error(
+      `Decompressed content too large: ${totalDecompressedSize} bytes (max: ${MAX_DECOMPRESSED_SIZE})`
+    );
+  }
   const sourceBytes = decompressed["source.ts"];
   const bundleBytes = decompressed["bundle.js"];
   if (!sourceBytes) {
@@ -69,8 +56,82 @@ function decompressTask(zipBuffer) {
     bundle
   };
 }
+
+// src/logger.ts
+var Logger = class _Logger {
+  logs = [];
+  static LOG_PREFIX = "__THYME_LOG__";
+  /**
+   * Log an info message
+   */
+  info(message) {
+    this.log("info", message);
+  }
+  /**
+   * Log a warning message
+   */
+  warn(message) {
+    this.log("warn", message);
+  }
+  /**
+   * Log an error message
+   */
+  error(message) {
+    this.log("error", message);
+  }
+  log(type, message) {
+    const entry = { type, message };
+    this.logs.push(entry);
+    console.log(`${_Logger.LOG_PREFIX}${JSON.stringify(entry)}`);
+  }
+  /**
+   * Get all collected logs
+   */
+  getLogs() {
+    return [...this.logs];
+  }
+  /**
+   * Clear all collected logs
+   */
+  clear() {
+    this.logs = [];
+  }
+};
+function createLogger() {
+  return new Logger();
+}
+
+// src/schema.ts
+import { getAddress, isAddress } from "viem";
+import { z } from "zod";
+var zodExtended = {
+  ...z,
+  /**
+   * Validates an Ethereum address and returns viem's Address type
+   * Accepts both checksummed and non-checksummed addresses
+   *
+   * @example
+   * ```typescript
+   * import { zodExtended as z } from '@thyme-sh/sdk'
+   *
+   * const schema = z.object({
+   *   targetAddress: z.address(),
+   * })
+   * ```
+   */
+  address: () => z.string().refine((val) => isAddress(val), {
+    message: "Invalid Ethereum address"
+  }).transform((val) => getAddress(val))
+};
+
+// src/task.ts
+function defineTask(definition) {
+  return definition;
+}
 export {
+  Logger,
   compressTask,
+  createLogger,
   decompressTask,
   defineTask,
   zodExtended as z

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/task.ts","../src/schema.ts","../src/archive.ts"],"sourcesContent":["import type { z } from 'zod'\nimport type { TaskDefinition } from './types'\n\n/**\n * Define a Web3 automation task\n *\n * @example\n * ```typescript\n * import { defineTask, z } from '@thyme-sh/sdk'\n * import { encodeFunctionData } from 'viem'\n *\n * const abi = [\n *   'function transfer(address to, uint256 amount) returns (bool)',\n * ] as const\n *\n * export default defineTask({\n *   schema: z.object({\n *     targetAddress: z.address(),\n *   }),\n *   async run(ctx) {\n *     return {\n *       canExec: true,\n *       calls: [{\n *         to: ctx.args.targetAddress,\n *         data: encodeFunctionData({\n *           abi,\n *           functionName: 'transfer',\n *           args: [recipientAddress, 1000n],\n *         }),\n *       }]\n *     }\n *   }\n * })\n * ```\n */\nexport function defineTask<TSchema extends z.ZodType>(\n\tdefinition: TaskDefinition<TSchema>,\n): TaskDefinition<TSchema> {\n\treturn definition\n}\n","import { type Address, getAddress, isAddress } from 'viem'\nimport { z } from 'zod'\n\n/**\n * Extended Zod with Ethereum address validation\n */\nexport const zodExtended = {\n\t...z,\n\t/**\n\t * Validates an Ethereum address and returns viem's Address type\n\t * Accepts both checksummed and non-checksummed addresses\n\t *\n\t * @example\n\t * ```typescript\n\t * import { zodExtended as z } from '@thyme-sh/sdk'\n\t *\n\t * const schema = z.object({\n\t *   targetAddress: z.address(),\n\t * })\n\t * ```\n\t */\n\taddress: () =>\n\t\tz\n\t\t\t.string()\n\t\t\t.refine((val): val is Address => isAddress(val), {\n\t\t\t\tmessage: 'Invalid Ethereum address',\n\t\t\t})\n\t\t\t.transform((val) => getAddress(val)),\n}\n\n/**\n * Type helper to infer the schema type\n */\nexport type InferSchema<T extends z.ZodType> = z.infer<T>\n","import { strFromU8, strToU8, unzipSync, zipSync } from 'fflate'\n\nexport interface CompressResult {\n\tzipBuffer: Uint8Array\n\tchecksum: string\n}\n\nexport interface DecompressResult {\n\tsource: string\n\tbundle: string\n}\n\n/**\n * Compress source and bundle into a ZIP archive\n * Uses fflate for fast, modern compression\n */\nexport function compressTask(source: string, bundle: string): CompressResult {\n\t// Create ZIP archive with both files\n\tconst files = {\n\t\t'source.ts': strToU8(source),\n\t\t'bundle.js': strToU8(bundle),\n\t}\n\n\tconst compressed = zipSync(files, {\n\t\tlevel: 6, // Balanced compression\n\t})\n\n\t// Calculate checksum (simple hash for now)\n\tlet hash = 0\n\tfor (let i = 0; i < compressed.length; i++) {\n\t\tconst byte = compressed[i]\n\t\tif (byte !== undefined) {\n\t\t\thash = (hash << 5) - hash + byte\n\t\t\thash = hash & hash // Convert to 32bit integer\n\t\t}\n\t}\n\tconst checksum = Math.abs(hash).toString(16)\n\n\treturn {\n\t\tzipBuffer: compressed,\n\t\tchecksum,\n\t}\n}\n\n/**\n * Decompress ZIP archive and extract source and bundle files\n * Uses fflate for fast decompression\n */\nexport function decompressTask(\n\tzipBuffer: Uint8Array | ArrayBuffer,\n): DecompressResult {\n\t// Convert ArrayBuffer to Uint8Array if needed\n\tconst uint8Array =\n\t\tzipBuffer instanceof ArrayBuffer ? new Uint8Array(zipBuffer) : zipBuffer\n\n\t// Decompress ZIP\n\tconst decompressed = unzipSync(uint8Array)\n\n\t// Extract files\n\tconst sourceBytes = decompressed['source.ts']\n\tconst bundleBytes = decompressed['bundle.js']\n\n\tif (!sourceBytes) {\n\t\tthrow new Error('source.ts not found in ZIP archive')\n\t}\n\n\tif (!bundleBytes) {\n\t\tthrow new Error('bundle.js not found in ZIP archive')\n\t}\n\n\t// Convert bytes to strings\n\tconst source = strFromU8(sourceBytes)\n\tconst bundle = strFromU8(bundleBytes)\n\n\treturn {\n\t\tsource,\n\t\tbundle,\n\t}\n}\n"],"mappings":";AAmCO,SAAS,WACf,YAC0B;AAC1B,SAAO;AACR;;;ACvCA,SAAuB,YAAY,iBAAiB;AACpD,SAAS,SAAS;AAKX,IAAM,cAAc;AAAA,EAC1B,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcH,SAAS,MACR,EACE,OAAO,EACP,OAAO,CAAC,QAAwB,UAAU,GAAG,GAAG;AAAA,IAChD,SAAS;AAAA,EACV,CAAC,EACA,UAAU,CAAC,QAAQ,WAAW,GAAG,CAAC;AACtC;;;AC5BA,SAAS,WAAW,SAAS,WAAW,eAAe;AAgBhD,SAAS,aAAa,QAAgB,QAAgC;AAE5E,QAAM,QAAQ;AAAA,IACb,aAAa,QAAQ,MAAM;AAAA,IAC3B,aAAa,QAAQ,MAAM;AAAA,EAC5B;AAEA,QAAM,aAAa,QAAQ,OAAO;AAAA,IACjC,OAAO;AAAA;AAAA,EACR,CAAC;AAGD,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC3C,UAAM,OAAO,WAAW,CAAC;AACzB,QAAI,SAAS,QAAW;AACvB,cAAQ,QAAQ,KAAK,OAAO;AAC5B,aAAO,OAAO;AAAA,IACf;AAAA,EACD;AACA,QAAM,WAAW,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE;AAE3C,SAAO;AAAA,IACN,WAAW;AAAA,IACX;AAAA,EACD;AACD;AAMO,SAAS,eACf,WACmB;AAEnB,QAAM,aACL,qBAAqB,cAAc,IAAI,WAAW,SAAS,IAAI;AAGhE,QAAM,eAAe,UAAU,UAAU;AAGzC,QAAM,cAAc,aAAa,WAAW;AAC5C,QAAM,cAAc,aAAa,WAAW;AAE5C,MAAI,CAAC,aAAa;AACjB,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACrD;AAEA,MAAI,CAAC,aAAa;AACjB,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACrD;AAGA,QAAM,SAAS,UAAU,WAAW;AACpC,QAAM,SAAS,UAAU,WAAW;AAEpC,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../src/archive.ts","../src/logger.ts","../src/schema.ts","../src/task.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport { strFromU8, strToU8, unzipSync, zipSync } from 'fflate'\n\nexport interface CompressResult {\n\tzipBuffer: Uint8Array\n\tchecksum: string\n}\n\nexport interface DecompressResult {\n\tsource: string\n\tbundle: string\n}\n\n// Maximum sizes for ZIP bomb protection\nconst MAX_ZIP_SIZE = 10 * 1024 * 1024 // 10MB compressed\nconst MAX_DECOMPRESSED_SIZE = 50 * 1024 * 1024 // 50MB decompressed\n\n/**\n * Calculate SHA-256 checksum of data\n */\nfunction calculateSha256(data: Uint8Array): string {\n\treturn createHash('sha256').update(data).digest('hex')\n}\n\n/**\n * Compress source and bundle into a ZIP archive\n * Uses fflate for fast, modern compression\n * Uses SHA-256 for cryptographically secure checksum\n */\nexport function compressTask(source: string, bundle: string): CompressResult {\n\t// Create ZIP archive with both files\n\tconst files = {\n\t\t'source.ts': strToU8(source),\n\t\t'bundle.js': strToU8(bundle),\n\t}\n\n\tconst compressed = zipSync(files, {\n\t\tlevel: 6, // Balanced compression\n\t})\n\n\t// Calculate SHA-256 checksum\n\tconst checksum = calculateSha256(compressed)\n\n\treturn {\n\t\tzipBuffer: compressed,\n\t\tchecksum,\n\t}\n}\n\n/**\n * Decompress ZIP archive and extract source and bundle files\n * Uses fflate for fast decompression\n * Includes ZIP bomb protection\n */\nexport function decompressTask(\n\tzipBuffer: Uint8Array | ArrayBuffer,\n): DecompressResult {\n\t// Convert ArrayBuffer to Uint8Array if needed\n\tconst uint8Array =\n\t\tzipBuffer instanceof ArrayBuffer ? new Uint8Array(zipBuffer) : zipBuffer\n\n\t// ZIP bomb protection: check compressed size\n\tif (uint8Array.length > MAX_ZIP_SIZE) {\n\t\tthrow new Error(\n\t\t\t`ZIP file too large: ${uint8Array.length} bytes (max: ${MAX_ZIP_SIZE})`,\n\t\t)\n\t}\n\n\t// Decompress ZIP\n\tconst decompressed = unzipSync(uint8Array)\n\n\t// ZIP bomb protection: check total decompressed size\n\tlet totalDecompressedSize = 0\n\tfor (const key of Object.keys(decompressed)) {\n\t\tconst file = decompressed[key]\n\t\tif (file) {\n\t\t\ttotalDecompressedSize += file.length\n\t\t}\n\t}\n\n\tif (totalDecompressedSize > MAX_DECOMPRESSED_SIZE) {\n\t\tthrow new Error(\n\t\t\t`Decompressed content too large: ${totalDecompressedSize} bytes (max: ${MAX_DECOMPRESSED_SIZE})`,\n\t\t)\n\t}\n\n\t// Extract files\n\tconst sourceBytes = decompressed['source.ts']\n\tconst bundleBytes = decompressed['bundle.js']\n\n\tif (!sourceBytes) {\n\t\tthrow new Error('source.ts not found in ZIP archive')\n\t}\n\n\tif (!bundleBytes) {\n\t\tthrow new Error('bundle.js not found in ZIP archive')\n\t}\n\n\t// Convert bytes to strings\n\tconst source = strFromU8(sourceBytes)\n\tconst bundle = strFromU8(bundleBytes)\n\n\treturn {\n\t\tsource,\n\t\tbundle,\n\t}\n}\n","// Declare console for environments that don't have DOM types\ndeclare const console: {\n\tlog: (...args: unknown[]) => void\n}\n\n/**\n * Log entry with type and message\n */\nexport interface LogEntry {\n\ttype: 'info' | 'warn' | 'error'\n\tmessage: string\n}\n\n/**\n * Logger for Thyme tasks\n *\n * Use this logger to output messages that will be captured and displayed\n * in the Thyme dashboard. Regular console.log calls will not be captured.\n *\n * @example\n * ```typescript\n * export default defineTask({\n *   schema: z.object({ ... }),\n *   async run(ctx) {\n *     ctx.logger.info('Starting task execution')\n *     ctx.logger.warn('Low balance detected')\n *     ctx.logger.error('Failed to fetch price')\n *     return { canExec: false, message: 'Error occurred' }\n *   }\n * })\n * ```\n */\nexport class Logger {\n\tprivate logs: LogEntry[] = []\n\tprivate static readonly LOG_PREFIX = '__THYME_LOG__'\n\n\t/**\n\t * Log an info message\n\t */\n\tinfo(message: string): void {\n\t\tthis.log('info', message)\n\t}\n\n\t/**\n\t * Log a warning message\n\t */\n\twarn(message: string): void {\n\t\tthis.log('warn', message)\n\t}\n\n\t/**\n\t * Log an error message\n\t */\n\terror(message: string): void {\n\t\tthis.log('error', message)\n\t}\n\n\tprivate log(type: LogEntry['type'], message: string): void {\n\t\tconst entry: LogEntry = { type, message }\n\t\tthis.logs.push(entry)\n\t\t// Output with special prefix so it can be captured by the runner\n\t\tconsole.log(`${Logger.LOG_PREFIX}${JSON.stringify(entry)}`)\n\t}\n\n\t/**\n\t * Get all collected logs\n\t */\n\tgetLogs(): LogEntry[] {\n\t\treturn [...this.logs]\n\t}\n\n\t/**\n\t * Clear all collected logs\n\t */\n\tclear(): void {\n\t\tthis.logs = []\n\t}\n}\n\n/**\n * Create a new logger instance\n */\nexport function createLogger(): Logger {\n\treturn new Logger()\n}\n","import { type Address, getAddress, isAddress } from 'viem'\nimport { z } from 'zod'\n\n/**\n * Extended Zod with Ethereum address validation\n */\nexport const zodExtended = {\n\t...z,\n\t/**\n\t * Validates an Ethereum address and returns viem's Address type\n\t * Accepts both checksummed and non-checksummed addresses\n\t *\n\t * @example\n\t * ```typescript\n\t * import { zodExtended as z } from '@thyme-sh/sdk'\n\t *\n\t * const schema = z.object({\n\t *   targetAddress: z.address(),\n\t * })\n\t * ```\n\t */\n\taddress: () =>\n\t\tz\n\t\t\t.string()\n\t\t\t.refine((val): val is Address => isAddress(val), {\n\t\t\t\tmessage: 'Invalid Ethereum address',\n\t\t\t})\n\t\t\t.transform((val) => getAddress(val)),\n}\n\n/**\n * Type helper to infer the schema type\n */\nexport type InferSchema<T extends z.ZodType> = z.infer<T>\n","import type { z } from 'zod'\nimport type { TaskDefinition } from './types'\n\n/**\n * Define a Web3 automation task\n *\n * @example\n * ```typescript\n * import { defineTask, z } from '@thyme-sh/sdk'\n * import { encodeFunctionData } from 'viem'\n *\n * const abi = [\n *   'function transfer(address to, uint256 amount) returns (bool)',\n * ] as const\n *\n * export default defineTask({\n *   schema: z.object({\n *     targetAddress: z.address(),\n *   }),\n *   async run(ctx) {\n *     return {\n *       canExec: true,\n *       calls: [{\n *         to: ctx.args.targetAddress,\n *         data: encodeFunctionData({\n *           abi,\n *           functionName: 'transfer',\n *           args: [recipientAddress, 1000n],\n *         }),\n *       }]\n *     }\n *   }\n * })\n * ```\n */\nexport function defineTask<TSchema extends z.ZodType>(\n\tdefinition: TaskDefinition<TSchema>,\n): TaskDefinition<TSchema> {\n\treturn definition\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,12 @@
 {
 	"name": "@thyme-sh/sdk",
-	"version": "0.2.0",
+	"version": "0.3.1",
 	"description": "SDK for authoring Web3 automation tasks",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/bnhpio/thyme-sdk.git",
+		"directory": "packages/sdk"
+	},
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -28,12 +33,17 @@
 	],
 	"author": "",
 	"license": "MIT",
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
 	"dependencies": {
 		"fflate": "^0.8.2",
 		"viem": "^2.21.54",
 		"zod": "^3.24.1"
 	},
 	"devDependencies": {
+		"@types/node": "^22.10.2",
 		"tsup": "^8.3.5",
 		"typescript": "^5.7.2"
 	}