@gnufoo/canaad 0.4.0 → 0.4.2

package/init.d.ts

@@ -1,11 +1,11 @@
 /**
  * Initialize WASM. Call once before using any WASM functions.
  *
- * @param wasmModule - Pass the WebAssembly.Module in Workers, omit in browser
+ * @param wasmModule - pass a precompiled WebAssembly.Module in Workers, omit in browser
  */
 export function initWasm(wasmModule?: WebAssembly.Module): Promise<void>;
 
 /**
- * Check if WASM has been initialized.
+ * True if WASM has been initialized via `initWasm()`.
  */
 export function isInitialized(): boolean;

package/init.js

@@ -6,7 +6,7 @@ let initPromise = null;
 /**
  * Initialize WASM. Call once before using any WASM functions.
  *
- * @param {WebAssembly.Module | undefined} wasmModule - Pass the Module in Workers, omit in browser
+ * @param {WebAssembly.Module | undefined} wasmModule - pass a precompiled module in Workers, omit in browser
  */
 export async function initWasm(wasmModule) {
   if (initialized) return;
@@ -19,6 +19,9 @@ export async function initWasm(wasmModule) {
   return initPromise;
 }
 
+/**
+ * True if WASM has been initialized via `initWasm()`.
+ */
 export function isInitialized() {
   return initialized;
 }

package/meta.d.ts

@@ -1,11 +1,18 @@
 import { z } from 'zod';
 
+/** Validates and parses all AAD action inputs. */
 export declare const inputSchema: z.ZodType;
+
+/** Validates and parses all AAD action outputs. */
 export declare const outputSchema: z.ZodType;
 
+/** Discriminated union of all action input shapes. */
 export type CanaadInput = z.infer<typeof inputSchema>;
+
+/** Discriminated union of all action output shapes. */
 export type CanaadOutput = z.infer<typeof outputSchema>;
 
+/** Tool metadata: id, name, slug, description, category, execution type, positional args, and schemas. */
 export declare const meta: {
   id: string;
   name: string;

package/meta.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 
 const extensionSchema = z.object({
   key: z.string().regex(/^x_[a-z]+_[a-z_]+$/),
-  value: z.union([z.string(), z.number().int().nonnegative()]),
+  value: z.union([z.string(), z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER)]),
 });
 
 export const inputSchema = z.discriminatedUnion('action', [
@@ -22,10 +22,10 @@ export const inputSchema = z.discriminatedUnion('action', [
   }),
   z.object({
     action: z.literal('build'),
-    tenant: z.string().min(1).max(256),
-    resource: z.string().min(1).max(1024),
+    tenant: z.string().min(1).refine(s => new TextEncoder().encode(s).length <= 256, 'tenant exceeds 256 bytes'),
+    resource: z.string().min(1).refine(s => new TextEncoder().encode(s).length <= 1024, 'resource exceeds 1024 bytes'),
     purpose: z.string().min(1),
-    timestamp: z.number().int().nonnegative().optional(),
+    timestamp: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).optional(),
     extensions: z.array(extensionSchema).optional(),
     outputFormat: z.enum(['bytes', 'string']).default('string'),
   }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnufoo/canaad",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "main": "canaad_wasm.js",
   "types": "canaad_wasm.d.ts",
@@ -40,5 +40,12 @@
     "wasm"
   ],
   "license": "MIT OR Apache-2.0",
-  "description": "AAD canonicalization library (RFC 8785)"
+  "description": "AAD canonicalization library (RFC 8785)",
+  "repository": {
+    "url": "https://gnu.foo/projects/canaad"
+  },
+  "homepage": "https://gnu.foo/projects/canaad",
+  "bugs": {
+    "email": "bugs@gnu.foo"
+  }
 }

package/tool.d.ts

@@ -1,8 +1,12 @@
 import type { meta, CanaadInput, CanaadOutput } from './meta.js';
 import type { initWasm, isInitialized } from './init.js';
 
+/**
+ * Main tool export. Merges AAD metadata with WASM lifecycle methods and the action dispatcher.
+ */
 export declare const toolDefinition: typeof meta & {
   initWasm: typeof initWasm;
   isInitialized: typeof isInitialized;
+  /** Dispatches an AAD action to WASM. Requires prior `initWasm()` call. */
   execute(input: CanaadInput): Promise<CanaadOutput>;
 };

package/tool.js

@@ -5,16 +5,17 @@ import { canonicalize, canonicalizeString, hash, validate, AadBuilder } from './
 const bytesToHex = (bytes) => Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('');
 const bytesToBase64 = (bytes) => globalThis.btoa(String.fromCharCode(...bytes));
 
+/**
+ * Main tool export. Merges AAD metadata with WASM lifecycle methods and the action dispatcher.
+ */
 export const toolDefinition = {
   ...meta,
-
-  /**
-   * Initialize WASM. Must be called before execute() in Workers.
-   * In browsers with vite-plugin-wasm, this is optional.
-   */
   initWasm,
   isInitialized,
 
+  /**
+   * Dispatches an AAD action to WASM. Requires prior `initWasm()` call.
+   */
   async execute(rawInput) {
     if (!isInitialized()) {
       throw new Error('WASM not initialized. Call initWasm() first.');