@hashgraphonline/standards-sdk 0.1.164 → 0.1.166

package/dist/browser/hcs-12/base-client.d.ts

@@ -0,0 +1,152 @@
+import { ILogger, LogLevel } from '../utils/logger';
+import { NetworkType } from '../utils/types';
+import { HederaMirrorNode, MirrorNodeConfig } from '../services';
+import { PrivateKey, PublicKey } from '../../node_modules/@hashgraph/sdk';
+import { ActionRegistry, BlockLoader, AssemblyRegistry, HashLinksRegistry } from './registries';
+import { ActionRegistration, BlockDefinition, AssemblyRegistration, HashLinksRegistration, RegistryType, AssemblyState } from './types';
+import { AssemblyEngine, Assembly } from './assembly';
+/**
+ * Configuration for HCS-12 client
+ */
+export interface HCS12Config {
+    /** The Hedera network to connect to */
+    network: NetworkType;
+    /** Custom logger instance (if not provided, one will be created) */
+    logger?: ILogger;
+    /** Log level for the client (ignored if logger is provided) */
+    logLevel?: LogLevel;
+    /** Whether to pretty print logs (ignored if logger is provided) */
+    prettyPrint?: boolean;
+    /** Custom mirror node configuration */
+    mirrorNode?: MirrorNodeConfig;
+    /** Whether to run logger in silent mode (ignored if logger is provided) */
+    silent?: boolean;
+    /** The key type to use for the operator */
+    keyType?: 'ed25519' | 'ecdsa';
+}
+/**
+ * Abstract base class for HCS-12 HashLinks clients
+ */
+export declare abstract class HCS12BaseClient {
+    protected network: NetworkType;
+    protected logger: ILogger;
+    mirrorNode: HederaMirrorNode;
+    protected _actionRegistry?: ActionRegistry;
+    protected _blockLoader?: BlockLoader;
+    protected _assemblyRegistry?: AssemblyRegistry;
+    protected _hashLinksRegistry?: HashLinksRegistry;
+    protected _assemblyEngine?: AssemblyEngine;
+    protected actionRegistryTopicId?: string;
+    protected _assemblyRegistryTopicId?: string;
+    protected _hashLinksRegistryTopicId?: string;
+    constructor(config: HCS12Config);
+    /**
+     * Initialize registries with optional existing topic IDs
+     */
+    protected initializeRegistries(topicIds?: {
+        action?: string;
+        assembly?: string;
+        hashlinks?: string;
+    }): void;
+    /**
+     * Create a new HCS topic for a registry
+     */
+    abstract createRegistryTopic(registryType: RegistryType, adminKey?: boolean | PublicKey, submitKey?: boolean | PublicKey): Promise<string>;
+    /**
+     * Submit a message to an HCS topic
+     */
+    abstract submitMessage(topicId: string, message: string, submitKey?: PrivateKey): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Register a new assembly in the assembly registry
+     */
+    registerAssembly(registration: AssemblyRegistration): Promise<{
+        id: string;
+        transactionId?: string;
+    }>;
+    /**
+     * Get action by hash
+     */
+    getAction(hash: string): Promise<ActionRegistration | null>;
+    /**
+     * Load block from HCS-1
+     */
+    loadBlock(blockTopicId: string): Promise<{
+        definition: BlockDefinition;
+        template: string;
+    }>;
+    /**
+     * Get assembly by name and version
+     */
+    getAssembly(name: string, version: string): Promise<AssemblyState | null>;
+    /**
+     * Load and resolve a complete assembly by topic ID
+     */
+    loadAssembly(topicId: string): Promise<Assembly>;
+    /**
+     * Get assembly state by topic ID (without resolving references)
+     */
+    getAssemblyState(topicId: string): Promise<AssemblyState | null>;
+    /**
+     * Ensure assembly engine is initialized
+     */
+    protected ensureAssemblyEngine(): void;
+    /**
+     * Register a new HashLink in the global directory
+     */
+    registerHashLink(registration: HashLinksRegistration): Promise<{
+        id: string;
+        transactionId?: string;
+    }>;
+    /**
+     * Search HashLinks by tags
+     */
+    searchHashLinksByTags(tags: string[]): Promise<HashLinksRegistration[]>;
+    /**
+     * Search HashLinks by name
+     */
+    searchHashLinksByName(searchTerm: string): Promise<HashLinksRegistration[]>;
+    /**
+     * Get featured HashLinks
+     */
+    getFeaturedHashLinks(): Promise<HashLinksRegistration[]>;
+    /**
+     * Get HashLinks by category
+     */
+    getHashLinksByCategory(category: string): Promise<HashLinksRegistration[]>;
+    /**
+     * Sync all registries with the network
+     */
+    syncRegistries(): Promise<void>;
+    /**
+     * Get registry topic IDs
+     */
+    getRegistryTopicIds(): {
+        action?: string;
+        assembly?: string;
+        hashlinks?: string;
+    };
+    /**
+     * Clear all registry caches
+     */
+    clearCaches(): void;
+    /**
+     * Get the action registry instance
+     */
+    get actionRegistry(): ActionRegistry | undefined;
+    /**
+     * Get the block loader instance
+     */
+    get blockLoader(): BlockLoader | undefined;
+    /**
+     * Get the assembly registry instance
+     */
+    get assemblyRegistry(): AssemblyRegistry | undefined;
+    /**
+     * Get the HashLinks registry instance
+     */
+    get hashLinksRegistry(): HashLinksRegistry | undefined;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/browser/hcs-12/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../../src/hcs-12/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,8BAAsB,eAAe;IACnC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAEpC,SAAS,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAC3C,SAAS,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;IACrC,SAAS,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IAC/C,SAAS,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACjD,SAAS,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAE3C,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACzC,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC5C,SAAS,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;gBAEjC,MAAM,EAAE,WAAW;IAmB/B;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE;QACxC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAMR;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAC1B,YAAY,EAAE,YAAY,EAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,EAC9B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAC9B,OAAO,CAAC,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,aAAa,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,UAAU,GACrB,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE9D;;OAEG;IACG,gBAAgB,CACpB,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IASlD;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAQjE;;OAEG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,UAAU,EAAE,eAAe,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAYF;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAehC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBtD;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAOtE;;OAEG;IACH,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAoBtC;;OAEG;IACG,gBAAgB,CACpB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IASlD;;OAEG;IACG,qBAAqB,CACzB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQnC;;OAEG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQnC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQ9D;;OAEG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQnC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC;;OAEG;IACH,mBAAmB,IAAI;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAQD;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAErD;CACF"}

package/dist/browser/hcs-12/browser.d.ts

@@ -0,0 +1,135 @@
+import { PrivateKey, PublicKey, KeyList } from '../../node_modules/@hashgraph/sdk';
+import { DAppSigner } from '../../node_modules/@hashgraph/hedera-wallet-connect/dist/index.d.ts';
+import { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';
+import { HCS12BaseClient, HCS12Config } from './base-client';
+import { RegistryType, AssemblyRegistration, AssemblyAddBlock, AssemblyAddAction, AssemblyUpdate, BlockDefinition } from './types';
+import { ActionBuilder, AssemblyBuilder, BlockBuilder } from './builders';
+import { RetrievedInscriptionResult } from '../inscribe/types';
+/**
+ * Configuration for HCS-12 browser client
+ */
+export interface HCS12BrowserClientConfig extends HCS12Config {
+    /** HashConnect Wallet Connect SDK instance */
+    hwc: HashinalsWalletConnectSDK;
+}
+/**
+ * HCS-12 browser client for client-side HashLinks operations
+ */
+export declare class HCS12BrowserClient extends HCS12BaseClient {
+    private hwc;
+    private accountId?;
+    constructor(config: HCS12BrowserClientConfig);
+    /**
+     * Update account ID from wallet connect session
+     */
+    private updateAccountFromWallet;
+    /**
+     * Get account and signer from wallet connect
+     */
+    getAccountAndSigner(): Promise<{
+        accountId: string;
+        signer: DAppSigner;
+    }>;
+    /**
+     * Get operator account ID (throws in browser)
+     */
+    getOperatorAccountId(): string;
+    /**
+     * Get operator private key (throws in browser)
+     */
+    getOperatorPrivateKey(): string;
+    /**
+     * Initialize registries with optional existing topic IDs
+     */
+    initializeRegistries(topicIds?: {
+        action?: string;
+        assembly?: string;
+        hashlinks?: string;
+    }): void;
+    /**
+     * Create a new HCS topic for a registry
+     */
+    createRegistryTopic(registryType: RegistryType, adminKey?: boolean | PublicKey | KeyList, submitKey?: boolean | PublicKey | KeyList): Promise<string>;
+    /**
+     * Create a new assembly topic
+     */
+    createAssemblyTopic(): Promise<string>;
+    /**
+     * Register an assembly on its own topic
+     */
+    registerAssemblyDirect(assemblyTopicId: string, registration: AssemblyRegistration): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Add a block to an assembly
+     */
+    addBlockToAssembly(assemblyTopicId: string, block: AssemblyAddBlock): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Add an action to an assembly
+     */
+    addActionToAssembly(assemblyTopicId: string, action: AssemblyAddAction): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Update assembly metadata
+     */
+    updateAssembly(assemblyTopicId: string, update: AssemblyUpdate): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Store a block (definition and template) via HCS-1
+     */
+    storeBlock(template: string, definition: BlockDefinition): Promise<{
+        definitionTopicId: string;
+        templateTopicId: string;
+    }>;
+    /**
+     * Submit a message to an HCS topic
+     * @deprecated Use operation-specific methods instead
+     */
+    submitMessage(topicId: string, message: string, submitKey?: PrivateKey): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Internal method to submit a message to an HCS topic
+     */
+    private _submitMessage;
+    /**
+     * Get the HashConnect instance
+     */
+    getHashConnect(): HashinalsWalletConnectSDK;
+    /**
+     * Get connected account ID
+     */
+    getAccountId(): string | undefined;
+    /**
+     * Check if wallet is connected
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Inscribe a file using HCS-1 via wallet signer (browser)
+     */
+    inscribeFile(buffer: Buffer, fileName: string, options?: {
+        progressCallback?: (progress: unknown) => void;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<RetrievedInscriptionResult>;
+    /**
+     * Register an action built with ActionBuilder
+     */
+    registerAction(builder: ActionBuilder): Promise<ActionBuilder>;
+    /**
+     * Register a block built with BlockBuilder
+     */
+    registerBlock(builder: BlockBuilder): Promise<BlockBuilder>;
+    createAssembly(): Promise<string>;
+    createAssembly(builder: AssemblyBuilder): Promise<string>;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser/hcs-12/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/hcs-12/browser.ts"],"names":[],"mappings":"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"}

package/dist/browser/hcs-12/builders/action-builder.d.ts

@@ -0,0 +1,112 @@
+import { Logger } from '../../utils/logger';
+import { ActionRegistration, SourceVerification, ValidationRule, ModuleInfo } from '../types';
+export interface BuildOptions {
+    validate?: boolean;
+}
+/**
+ * Builder for creating action registrations with validation
+ */
+export declare class ActionBuilder {
+    private logger;
+    private registration;
+    private alias?;
+    private cryptoAdapter;
+    constructor(logger: Logger);
+    /**
+     * Set HCS-1 topic ID for WASM storage
+     */
+    setTopicId(topicId: string): ActionBuilder;
+    /**
+     * Set alias for this action in the assembly
+     */
+    setAlias(alias: string): ActionBuilder;
+    /**
+     * Set INFO hash
+     */
+    setHash(hash: string): ActionBuilder;
+    /**
+     * Set WASM hash
+     */
+    setWasmHash(hash: string): ActionBuilder;
+    /**
+     * Set optional INFO topic ID
+     */
+    setInfoTopicId(topicId: string): ActionBuilder;
+    /**
+     * Set JavaScript wrapper topic ID
+     */
+    setJsTopicId(topicId: string): ActionBuilder;
+    /**
+     * Set JavaScript wrapper hash
+     */
+    setJsHash(hash: string): ActionBuilder;
+    /**
+     * Set interface version (wasm-bindgen version)
+     */
+    setInterfaceVersion(version: string): ActionBuilder;
+    /**
+     * Add validation rule for an action
+     */
+    addValidationRule(action: string, rule: ValidationRule): ActionBuilder;
+    /**
+     * Set source verification data
+     */
+    setSourceVerification(verification: SourceVerification): ActionBuilder;
+    /**
+     * Build the action registration
+     */
+    build(options?: BuildOptions): ActionRegistration;
+    /**
+     * Reset the builder
+     */
+    reset(): ActionBuilder;
+    /**
+     * Get the alias
+     */
+    getAlias(): string;
+    /**
+     * Get the topic ID
+     */
+    getTopicId(): string;
+    /**
+     * Generate WASM hash from binary data
+     */
+    generateWasmHash(wasmData: Uint8Array): Promise<string>;
+    /**
+     * Generate INFO hash from module info
+     */
+    generateInfoHash(info: ModuleInfo): Promise<string>;
+    /**
+     * Calculate hash for any data
+     */
+    calculateHash(data: Uint8Array | Buffer | string): Promise<string>;
+    /**
+     * Create SSR-safe hash
+     */
+    private createSSRSafeHash;
+    /**
+     * Create registration from WASM and INFO data
+     */
+    createFromWasmAndInfo(topicId: string, wasmData: Uint8Array, info: ModuleInfo): Promise<ActionRegistration>;
+    /**
+     * Check if registration is complete
+     */
+    isComplete(registration: Partial<ActionRegistration>): boolean;
+    /**
+     * Validate the current registration
+     */
+    private validate;
+    /**
+     * Validate topic ID format
+     */
+    private isValidTopicId;
+    /**
+     * Validate hash format
+     */
+    private isValidHash;
+    /**
+     * Validate semantic version format
+     */
+    private isValidVersion;
+}
+//# sourceMappingURL=action-builder.d.ts.map

package/dist/browser/hcs-12/builders/action-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-builder.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/builders/action-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,aAAa,CAAsB;gBAE/B,MAAM,EAAE,MAAM;IAQ1B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAQ1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAKtC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQxC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAQ9C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAQ5C;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQtC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAQnD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,aAAa;IAQtE;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,aAAa;IActE;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,YAAiC,GAAG,kBAAkB;IAQrE;;OAEG;IACH,KAAK,IAAI,aAAa;IAStB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAOlB;;OAEG;IACH,UAAU,IAAI,MAAM;IAOpB;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAazD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBxE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,kBAAkB,CAAC;IAiB9B;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO;IAU9D;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB"}

package/dist/browser/hcs-12/builders/assembly-builder.d.ts

@@ -0,0 +1,98 @@
+import { Logger } from '../../utils/logger';
+import { AssemblyRegistration, AssemblyAddAction, AssemblyAddBlock, AssemblyUpdate, AssemblyState } from '../types';
+import { ActionBuilder } from './action-builder';
+import { BlockBuilder } from './block-builder';
+/**
+ * Builder for creating HashLink assemblies using incremental operations
+ */
+export declare class AssemblyBuilder {
+    private logger;
+    private registration;
+    private operations;
+    private updateFields;
+    constructor(logger?: Logger);
+    /**
+     * Set assembly name
+     */
+    setName(name: string): AssemblyBuilder;
+    /**
+     * Set assembly version
+     */
+    setVersion(version: string): AssemblyBuilder;
+    /**
+     * Set assembly description
+     */
+    setDescription(description: string): AssemblyBuilder;
+    /**
+     * Set assembly tags
+     */
+    setTags(tags: string[]): AssemblyBuilder;
+    /**
+     * Add a single tag
+     */
+    addTag(tag: string): AssemblyBuilder;
+    /**
+     * Set assembly author
+     */
+    setAuthor(author: string): AssemblyBuilder;
+    /**
+     * Add an action to the assembly
+     */
+    addAction(builder: ActionBuilder): AssemblyBuilder;
+    /**
+     * Add a block to the assembly
+     * The block must already be registered and have a topic ID
+     */
+    addBlock(builder: BlockBuilder): AssemblyBuilder;
+    /**
+     * Update assembly metadata
+     */
+    updateMetadata(description?: string, tags?: string[]): AssemblyBuilder;
+    /**
+     * Build the assembly registration
+     */
+    build(): AssemblyRegistration;
+    /**
+     * Build an update operation
+     */
+    buildUpdate(): AssemblyUpdate;
+    /**
+     * Build all operations
+     */
+    buildOperations(): (AssemblyAddAction | AssemblyAddBlock | AssemblyUpdate)[];
+    /**
+     * Reset the builder
+     */
+    reset(): AssemblyBuilder;
+    /**
+     * Get the registration message
+     */
+    getRegistration(): AssemblyRegistration;
+    /**
+     * Get all operations
+     */
+    getOperations(): (AssemblyAddAction | AssemblyAddBlock | AssemblyUpdate)[];
+    /**
+     * Build the complete assembly definition for preview
+     */
+    buildPreview(): AssemblyState;
+    /**
+     * Validate the assembly configuration
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Helper validation methods
+     */
+    private isValidSemver;
+    private isValidTopicId;
+    private isValidAlias;
+    private isValidName;
+    /**
+     * Extract default values from block attributes
+     */
+    private extractDefaultAttributes;
+}
+//# sourceMappingURL=assembly-builder.d.ts.map

package/dist/browser/hcs-12/builders/assembly-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly-builder.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/builders/assembly-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAGd,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAGlB;IACF,OAAO,CAAC,UAAU,CAIT;IACT,OAAO,CAAC,YAAY,CAGlB;gBAEU,MAAM,CAAC,EAAE,MAAM;IAI3B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAQtC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAQ5C;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IAQpD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe;IAQxC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAYpC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAK1C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe;IAmBlD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe;IAgChD;;OAEG;IACH,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,eAAe;IAYtE;;OAEG;IACH,KAAK,IAAI,oBAAoB;IAU7B;;OAEG;IACH,WAAW,IAAI,cAAc;IAc7B;;OAEG;IACH,eAAe,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,GAAG,cAAc,CAAC,EAAE;IAI5E;;OAEG;IACH,KAAK,IAAI,eAAe;IAaxB;;OAEG;IACH,eAAe,IAAI,oBAAoB;IAIvC;;OAEG;IACH,aAAa,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,GAAG,cAAc,CAAC,EAAE;IAI1E;;OAEG;IACH,YAAY,IAAI,aAAa;IAgD7B;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAmEhD;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAajC"}

package/dist/browser/hcs-12/builders/block-builder.d.ts

@@ -0,0 +1,135 @@
+import { BlockDefinition, BlockSupports } from '../types';
+/**
+ * BlockBuilder provides a fluent interface for creating HCS-12 block definitions.
+ *
+ * Example usage:
+ * ```typescript
+ * const counterBlock = new BlockBuilder()
+ *   .setName('hashlink/counter')
+ *   .setTitle('Counter Block')
+ *   .setDescription('A simple counter with increment/decrement')
+ *   .setCategory('interactive')
+ *   .setIcon('calculator')
+ *   .addAttribute('count', 'number', 0)
+ *   .addAttribute('step', 'number', 1)
+ *   .addAttribute('label', 'string', 'Counter')
+ *   .setTemplateFromFile('./counter-template.html')
+ *   .addAction('increment', 'Increment the counter')
+ *   .addAction('decrement', 'Decrement the counter')
+ *   .addAction('reset', 'Reset to zero')
+ *   .build();
+ * ```
+ */
+export declare class BlockBuilder {
+    private block;
+    private attributes;
+    private supports;
+    private templateTopicId?;
+    private templateBuffer?;
+    private actions;
+    private blockTopicId?;
+    private logger;
+    constructor();
+    /**
+     * Set the block name (e.g., 'hashlink/counter')
+     */
+    setName(name: string): this;
+    /**
+     * Set the block title for display
+     */
+    setTitle(title: string): this;
+    /**
+     * Set the block description
+     */
+    setDescription(description: string): this;
+    /**
+     * Set the block category
+     */
+    setCategory(category: string): this;
+    /**
+     * Set the block icon (dashicon name)
+     */
+    setIcon(icon: string): this;
+    /**
+     * Set keywords for search
+     */
+    setKeywords(keywords: string[]): this;
+    /**
+     * Set the API version
+     */
+    setApiVersion(version: number): this;
+    /**
+     * Add a block attribute
+     */
+    addAttribute(name: string, type: 'string' | 'number' | 'boolean' | 'object' | 'array', defaultValue: any, options?: {
+        enum?: any[];
+        source?: string;
+        selector?: string;
+        attribute?: string;
+    }): this;
+    /**
+     * Set the template topic ID
+     */
+    setTemplateTopicId(topicId: string): this;
+    /**
+     * Set the template buffer
+     */
+    setTemplate(template: Buffer): this;
+    /**
+     * Map actions for this block
+     */
+    setActions(actions: Record<string, string>): this;
+    /**
+     * Add a single action mapping
+     */
+    addAction(name: string, topicId: string): this;
+    /**
+     * Add block supports (e.g., align, anchor, etc.)
+     */
+    addSupport(feature: keyof BlockSupports, value?: any): this;
+    /**
+     * Enable common supports
+     */
+    enableCommonSupports(): this;
+    /**
+     * Build the block definition
+     */
+    build(): BlockDefinition;
+    /**
+     * Create a simple display block
+     */
+    static createDisplayBlock(name: string, title: string): BlockBuilder;
+    /**
+     * Create an interactive block
+     */
+    static createInteractiveBlock(name: string, title: string): BlockBuilder;
+    /**
+     * Create a widget block (alias for interactive block)
+     */
+    static createWidgetBlock(name: string, title: string): BlockBuilder;
+    /**
+     * Create a container block (for nesting)
+     */
+    static createContainerBlock(name: string, title: string): BlockBuilder;
+    /**
+     * Get the template buffer if set
+     */
+    getTemplate(): Buffer | undefined;
+    /**
+     * Get the actions mapping
+     */
+    getActions(): Record<string, string>;
+    /**
+     * Set the block topic ID (after registration)
+     */
+    setTopicId(topicId: string): this;
+    /**
+     * Get the block topic ID
+     */
+    getTopicId(): string;
+    /**
+     * Get the block name (if set)
+     */
+    getName(): string | undefined;
+}
+//# sourceMappingURL=block-builder.d.ts.map

package/dist/browser/hcs-12/builders/block-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-builder.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/builders/block-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,aAAa,EAEd,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAEX;IACF,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAS;;IAMvB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKrC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,EAC1D,YAAY,EAAE,GAAG,EACjB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,IAAI;IAeP;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKjD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,aAAa,EAAE,KAAK,GAAE,GAAU,GAAG,IAAI;IAKjE;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAc5B;;OAEG;IACH,KAAK,IAAI,eAAe;IA4BxB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IAQpE;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IAQxE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IAInE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IAStE;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,UAAU,IAAI,MAAM;IAOpB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;CAG9B"}

package/dist/browser/hcs-12/builders/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HCS-12 Builder Exports
+ */
+export * from './action-builder';
+export * from './assembly-builder';
+export * from './block-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/hcs-12/builders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/builders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}