neozip-blockchain 0.7.0 → 0.7.2

package/dist/{zipstamp-server/ZipstampServerHelpers.d.ts → token-service/TokenServiceHelpers.d.ts}

@@ -1,17 +1,17 @@
 /**
- * Zipstamp Server Helpers
+ * NeoZip Token Service helpers
  *
- * High-level convenience functions for interacting with the Zipstamp server API.
+ * High-level convenience functions for interacting with the NeoZip Token Service API.
  * These functions provide a simplified interface for common operations like
  * submitting digests, verifying timestamps, polling for confirmation, and NFT operations.
  *
- * This module wraps the core ZipstampServerClient with convenience functions
+ * This module wraps the core TokenServiceClient with convenience functions
  * and response type transformations for easier use in applications.
  */
-import { ZipstampServerClient, type PrepareMintResponse, type NFTStatusResponse, type NFTContractInfoResponse } from './ZipstampServerClient';
-import { getZipStampServerUrl } from '../constants/servers';
+import { TokenServiceClient, type VerificationDelivery, type PrepareMintResponse, type NFTStatusResponse, type NFTContractInfoResponse } from './TokenServiceClient';
+import { getTokenServiceUrl } from '../constants/servers';
 /**
- * Response from submitting a digest to the Zipstamp server.
+ * Response from submitting a digest to the NeoZip Token Service.
  *
  * Returned by `submitDigest` function after submitting a digest for timestamping.
  */
@@ -26,7 +26,7 @@ export interface SubmitDigestResponse {
     error?: string;
 }
 /**
- * Response from verifying a digest with the Zipstamp server.
+ * Response from verifying a digest with the NeoZip Token Service.
  *
  * Returned by `verifyDigest` and `pollForConfirmation` functions after checking
  * timestamp status. Contains detailed blockchain information if confirmed.
@@ -75,7 +75,7 @@ export interface TimestampMetadata {
  * Extended Token Metadata (compatible with neozipkit TokenMetadata)
  *
  * This interface extends the base TokenMetadata with timestamp proof information
- * for NFTs minted from timestamped ZIP files via the Zipstamp server.
+ * for NFTs minted from timestamped ZIP files via the NeoZip Token Service.
  *
  * The timestampProof section links the NFT to the original timestamp batch,
  * proving both NFT ownership AND timestamp verification.
@@ -104,27 +104,39 @@ export interface ExtendedTokenMetadata {
         serverUrl: string;
     };
 }
-export type { PrepareMintResponse, NFTStatusResponse, NFTContractInfoResponse } from './ZipstampServerClient';
+export type { PrepareMintResponse, NFTStatusResponse, NFTContractInfoResponse } from './TokenServiceClient';
 /**
- * Options for Zipstamp server helper functions.
+ * Options for NeoZip Token Service helper functions.
  *
- * Common configuration options used across helper functions in ZipstampServerHelpers.
+ * Common configuration options used across helper functions in TokenServiceHelpers.
  * Stamping requires a verified email in the request (no API key).
  */
-export interface ZipstampServerHelperOptions {
-    /** Zipstamp server URL (defaults to library constant / ZIPSTAMP_SERVER_URL or TOKEN_SERVER_URL env) */
+export interface TokenServiceHelperOptions {
+    /** NeoZip Token Service URL (defaults to library constant / TOKEN_SERVICE_URL env) */
     serverUrl?: string;
-    /** Key into ZIPSTAMP_SERVER_URLS (e.g. "default", "staging") */
+    /** Key into TOKEN_SERVICE_URLS (e.g. "default", "staging") */
     serverKey?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Only used by {@link registerEmail}: forwarded as `verificationDelivery` on `POST /auth/register`.
+     * `browser` (default when omitted): web confirm link + code. `app`: deep link + code only.
+     */
+    verificationDelivery?: VerificationDelivery;
 }
 /** Re-export for callers that need to resolve server URL (single source: constants/servers.ts) */
-export { getZipStampServerUrl };
+export { getTokenServiceUrl };
 /**
- * Submits a digest to the Zipstamp server for blockchain timestamping.
+ * Parses env or CLI values for {@link registerEmail} (`POST /auth/register` body field `verificationDelivery`).
  *
- * Sends a SHA-256 digest (merkle root) to the Zipstamp server API to be included
+ * @returns `undefined` when absent or empty (server defaults to `browser`).
+ * @throws Error when a non-empty value is not `browser` or `app`.
+ */
+export declare function parseVerificationDeliveryInput(raw: unknown): VerificationDelivery | undefined;
+/**
+ * Submits a digest to the NeoZip Token Service for blockchain timestamping.
+ *
+ * Sends a SHA-256 digest (merkle root) to the NeoZip Token Service API to be included
  * in the next batch for blockchain timestamping. The digest is typically the
  * merkle root of a ZIP file's contents.
  *
@@ -135,7 +147,7 @@ export { getZipStampServerUrl };
  * @param email - Email address (must be verified on the server)
  * @param chainId - Optional chain ID hint (server may use this to select the network)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to response containing batch information and status
  *
@@ -154,20 +166,20 @@ export { getZipStampServerUrl };
  * }
  * ```
  */
-export declare function submitDigest(digest: string, email?: string, chainId?: number, options?: ZipstampServerHelperOptions): Promise<SubmitDigestResponse>;
+export declare function submitDigest(digest: string, email?: string, chainId?: number, options?: TokenServiceHelperOptions): Promise<SubmitDigestResponse>;
 /**
- * Verifies a digest using the Zipstamp server API.
+ * Verifies a digest using the NeoZip Token Service API.
  *
- * Checks with the Zipstamp server whether a digest has been confirmed on the blockchain.
+ * Checks with the NeoZip Token Service whether a digest has been confirmed on the blockchain.
  * Returns detailed verification information including transaction hash, block number,
  * and merkle proof data if the timestamp is confirmed.
  *
  * @param digest - The SHA-256 digest (64-character hex string) to verify
  * @param chainId - Optional chain ID hint to help server select the correct network
  * @param batchId - Optional batch ID hint to help server disambiguate if digest appears in multiple batches
- * @param client - Optional pre-configured ZipstampServerClient instance (useful for polling with custom timeout/retry settings)
+ * @param client - Optional pre-configured TokenServiceClient instance (useful for polling with custom timeout/retry settings)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to verification response with status and blockchain details
  *
@@ -191,11 +203,11 @@ export declare function submitDigest(digest: string, email?: string, chainId?: n
  * }
  * ```
  */
-export declare function verifyDigest(digest: string, chainId?: number, batchId?: string, client?: ZipstampServerClient, options?: ZipstampServerHelperOptions): Promise<VerifyDigestResponse>;
+export declare function verifyDigest(digest: string, chainId?: number, batchId?: string, client?: TokenServiceClient, options?: TokenServiceHelperOptions): Promise<VerifyDigestResponse>;
 /**
- * Polls the Zipstamp server for confirmation of a digest.
+ * Polls the NeoZip Token Service for confirmation of a digest.
  *
- * Continuously checks the Zipstamp server API until the digest is confirmed on the
+ * Continuously checks the NeoZip Token Service API until the digest is confirmed on the
  * blockchain or the timeout is reached. Uses deadline-aware polling with per-request
  * timeouts to ensure proper exit behavior.
  *
@@ -210,7 +222,7 @@ export declare function verifyDigest(digest: string, chainId?: number, batchId?:
  * @param timeout - Maximum time to poll in milliseconds (default: 300000 = 5 minutes)
  * @param interval - Time between polling attempts in milliseconds (default: 5000 = 5 seconds)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to verification response if confirmed, or `null` if timeout reached
  *
@@ -238,7 +250,7 @@ export declare function verifyDigest(digest: string, chainId?: number, batchId?:
  */
 export declare function pollForConfirmation(digest: string, chainId?: number, batchId?: string, timeout?: number, // 5 minutes default
 interval?: number, // 5 seconds default
-options?: ZipstampServerHelperOptions): Promise<VerifyDigestResponse | null>;
+options?: TokenServiceHelperOptions): Promise<VerifyDigestResponse | null>;
 /**
  * Prepares mint data for NFT proof token minting.
  *
@@ -254,7 +266,7 @@ options?: ZipstampServerHelperOptions): Promise<VerifyDigestResponse | null>;
  * @param chainId - Optional chain ID hint
  * @param batchId - Optional batch ID from TIMESTAMP.NZIP metadata to ensure the correct batch is used
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to mint data response containing all parameters needed for contract call
  *
@@ -277,18 +289,18 @@ options?: ZipstampServerHelperOptions): Promise<VerifyDigestResponse | null>;
  * }
  * ```
  */
-export declare function prepareMint(digest: string, chainId?: number, batchId?: string, options?: ZipstampServerHelperOptions): Promise<PrepareMintResponse>;
+export declare function prepareMint(digest: string, chainId?: number, batchId?: string, options?: TokenServiceHelperOptions): Promise<PrepareMintResponse>;
 /**
  * Checks if a digest has already been minted as an NFT proof token.
  *
- * Queries the Zipstamp server to determine if a digest has been minted as an NFT
+ * Queries the NeoZip Token Service to determine if a digest has been minted as an NFT
  * on the TimestampProofNFT contract. Returns token information if minted, including
  * token ID, owner, and proof data.
  *
  * @param digest - The SHA-256 digest (64-character hex string) to check
  * @param chainId - Optional chain ID hint
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to NFT status response indicating if minted and token details
  *
@@ -305,16 +317,16 @@ export declare function prepareMint(digest: string, chainId?: number, batchId?:
  * }
  * ```
  */
-export declare function checkNFTStatus(digest: string, chainId?: number, options?: ZipstampServerHelperOptions): Promise<NFTStatusResponse>;
+export declare function checkNFTStatus(digest: string, chainId?: number, options?: TokenServiceHelperOptions): Promise<NFTStatusResponse>;
 /**
- * Retrieves NFT contract information from the Zipstamp server.
+ * Retrieves NFT contract information from the NeoZip Token Service.
  *
  * Gets details about the TimestampProofNFT contract for a given network,
  * including contract address, registry address, minting fee, and version.
  *
  * @param chainId - Optional chain ID hint (if not provided, server uses default network)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to contract information response
  *
@@ -330,9 +342,9 @@ export declare function checkNFTStatus(digest: string, chainId?: number, options
  * }
  * ```
  */
-export declare function getNFTContractInfo(chainId?: number, options?: ZipstampServerHelperOptions): Promise<NFTContractInfoResponse>;
-import type { RegisterResponse, VerifyEmailResponse, CalendarIdentity, HealthCheckResponse } from './ZipstampServerClient';
-export type { RegisterRequest, RegisterResponse, VerifyEmailRequest, VerifyEmailResponse, CalendarIdentity, CalendarChainInfo, HealthCheckResponse, ComponentHealth, } from './ZipstampServerClient';
+export declare function getNFTContractInfo(chainId?: number, options?: TokenServiceHelperOptions): Promise<NFTContractInfoResponse>;
+import type { RegisterResponse, VerifyEmailResponse, CalendarIdentity, HealthCheckResponse } from './TokenServiceClient';
+export type { RegisterRequest, RegisterResponse, VerificationDelivery, VerifyEmailRequest, VerifyEmailResponse, CalendarIdentity, CalendarChainInfo, HealthCheckResponse, ComponentHealth, } from './TokenServiceClient';
 /**
  * Register an email address with a calendar server.
  *
@@ -344,7 +356,8 @@ export type { RegisterRequest, RegisterResponse, VerifyEmailRequest, VerifyEmail
  *
  * @param email - Email address to register
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
+ * @param options.verificationDelivery - `browser` (default) or `app`; matches token service `POST /auth/register`
  * @returns Promise resolving to registration response
  *
  * @example
@@ -358,7 +371,7 @@ export type { RegisterRequest, RegisterResponse, VerifyEmailRequest, VerifyEmail
  * }
  * ```
  */
-export declare function registerEmail(email: string, options?: ZipstampServerHelperOptions): Promise<RegisterResponse>;
+export declare function registerEmail(email: string, options?: TokenServiceHelperOptions): Promise<RegisterResponse>;
 /**
  * Verify email with code.
  *
@@ -372,10 +385,10 @@ export declare function registerEmail(email: string, options?: ZipstampServerHel
  * @param email - Email address that was registered
  * @param code - Verification code from email
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @returns Promise resolving to verification response
  */
-export declare function verifyEmailCode(email: string, code: string, options?: ZipstampServerHelperOptions): Promise<VerifyEmailResponse>;
+export declare function verifyEmailCode(email: string, code: string, options?: TokenServiceHelperOptions): Promise<VerifyEmailResponse>;
 /**
  * Get calendar server identity and capabilities.
  *
@@ -385,7 +398,7 @@ export declare function verifyEmailCode(email: string, code: string, options?: Z
  * PUBLIC: No API key required.
  *
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @returns Promise resolving to calendar identity information
  *
  * @example
@@ -399,7 +412,7 @@ export declare function verifyEmailCode(email: string, code: string, options?: Z
  * console.log('Chains:', calendar.chains.map(c => c.network).join(', '));
  * ```
  */
-export declare function getCalendarIdentity(options?: ZipstampServerHelperOptions): Promise<CalendarIdentity>;
+export declare function getCalendarIdentity(options?: TokenServiceHelperOptions): Promise<CalendarIdentity>;
 /**
  * Check health of a calendar server.
  *
@@ -409,7 +422,7 @@ export declare function getCalendarIdentity(options?: ZipstampServerHelperOption
  * PUBLIC: No API key required.
  *
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @param full - If true, returns detailed component health (default: false)
  * @returns Promise resolving to health check response
  *
@@ -426,5 +439,5 @@ export declare function getCalendarIdentity(options?: ZipstampServerHelperOption
  * }
  * ```
  */
-export declare function checkCalendarHealth(options?: ZipstampServerHelperOptions, full?: boolean): Promise<HealthCheckResponse>;
-//# sourceMappingURL=ZipstampServerHelpers.d.ts.map
+export declare function checkCalendarHealth(options?: TokenServiceHelperOptions, full?: boolean): Promise<HealthCheckResponse>;
+//# sourceMappingURL=TokenServiceHelpers.d.ts.map

package/dist/token-service/TokenServiceHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenServiceHelpers.d.ts","sourceRoot":"","sources":["../../src/token-service/TokenServiceHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAEpC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,cAAc,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAGD,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAM5G;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAMD,kGAAkG;AAClG,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAkB9B;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAO7F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA6B/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,MAAe,EAAE,oBAAoB;AAC9C,QAAQ,GAAE,MAAa,EAAE,oBAAoB;AAC7C,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAoEtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAMD,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,yBAAyB,EACnC,IAAI,GAAE,OAAe,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}

package/dist/{zipstamp-server/ZipstampServerHelpers.js → token-service/TokenServiceHelpers.js}

@@ -1,16 +1,17 @@
 "use strict";
 /**
- * Zipstamp Server Helpers
+ * NeoZip Token Service helpers
  *
- * High-level convenience functions for interacting with the Zipstamp server API.
+ * High-level convenience functions for interacting with the NeoZip Token Service API.
  * These functions provide a simplified interface for common operations like
  * submitting digests, verifying timestamps, polling for confirmation, and NFT operations.
  *
- * This module wraps the core ZipstampServerClient with convenience functions
+ * This module wraps the core TokenServiceClient with convenience functions
  * and response type transformations for easier use in applications.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getZipStampServerUrl = void 0;
+exports.getTokenServiceUrl = void 0;
+exports.parseVerificationDeliveryInput = parseVerificationDeliveryInput;
 exports.submitDigest = submitDigest;
 exports.verifyDigest = verifyDigest;
 exports.pollForConfirmation = pollForConfirmation;
@@ -21,27 +22,46 @@ exports.registerEmail = registerEmail;
 exports.verifyEmailCode = verifyEmailCode;
 exports.getCalendarIdentity = getCalendarIdentity;
 exports.checkCalendarHealth = checkCalendarHealth;
-const ZipstampServerClient_1 = require("./ZipstampServerClient");
+const TokenServiceClient_1 = require("./TokenServiceClient");
 const servers_1 = require("../constants/servers");
-Object.defineProperty(exports, "getZipStampServerUrl", { enumerable: true, get: function () { return servers_1.getZipStampServerUrl; } });
+Object.defineProperty(exports, "getTokenServiceUrl", { enumerable: true, get: function () { return servers_1.getTokenServiceUrl; } });
 function getClient(options) {
-    return new ZipstampServerClient_1.ZipstampServerClient({
-        serverUrl: (0, servers_1.getZipStampServerUrl)(options),
+    return new TokenServiceClient_1.TokenServiceClient({
+        serverUrl: (0, servers_1.getTokenServiceUrl)(options),
     });
 }
 function shouldDebug(options) {
     if (options?.debug !== undefined) {
         return options.debug;
     }
-    return process.env.ZIPSTAMP_DEBUG === 'true' || process.env.DEBUG === 'true';
+    return (process.env.TOKEN_SERVICE_DEBUG === 'true' ||
+        process.env.DEBUG === 'true');
+}
+/**
+ * Parses env or CLI values for {@link registerEmail} (`POST /auth/register` body field `verificationDelivery`).
+ *
+ * @returns `undefined` when absent or empty (server defaults to `browser`).
+ * @throws Error when a non-empty value is not `browser` or `app`.
+ */
+function parseVerificationDeliveryInput(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    const s = String(raw).trim().toLowerCase();
+    if (s === '')
+        return undefined;
+    if (s === 'browser')
+        return 'browser';
+    if (s === 'app')
+        return 'app';
+    throw new Error(`verificationDelivery must be "browser" or "app" (got: ${JSON.stringify(raw)})`);
 }
 // ============================================================================
 // API Functions
 // ============================================================================
 /**
- * Submits a digest to the Zipstamp server for blockchain timestamping.
+ * Submits a digest to the NeoZip Token Service for blockchain timestamping.
  *
- * Sends a SHA-256 digest (merkle root) to the Zipstamp server API to be included
+ * Sends a SHA-256 digest (merkle root) to the NeoZip Token Service API to be included
  * in the next batch for blockchain timestamping. The digest is typically the
  * merkle root of a ZIP file's contents.
  *
@@ -52,7 +72,7 @@ function shouldDebug(options) {
  * @param email - Email address (must be verified on the server)
  * @param chainId - Optional chain ID hint (server may use this to select the network)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to response containing batch information and status
  *
@@ -75,11 +95,11 @@ async function submitDigest(digest, email, chainId, options) {
     const client = getClient(options);
     const reqBody = { digest, chainId, email };
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /stamp request:', JSON.stringify(reqBody, null, 2));
+        console.log('[TokenService] POST /stamp request:', JSON.stringify(reqBody, null, 2));
     }
     const res = await client.stamp(reqBody);
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /stamp response:', JSON.stringify(res, null, 2));
+        console.log('[TokenService] POST /stamp response:', JSON.stringify(res, null, 2));
     }
     return {
         success: res.success,
@@ -93,18 +113,18 @@ async function submitDigest(digest, email, chainId, options) {
     };
 }
 /**
- * Verifies a digest using the Zipstamp server API.
+ * Verifies a digest using the NeoZip Token Service API.
  *
- * Checks with the Zipstamp server whether a digest has been confirmed on the blockchain.
+ * Checks with the NeoZip Token Service whether a digest has been confirmed on the blockchain.
  * Returns detailed verification information including transaction hash, block number,
  * and merkle proof data if the timestamp is confirmed.
  *
  * @param digest - The SHA-256 digest (64-character hex string) to verify
  * @param chainId - Optional chain ID hint to help server select the correct network
  * @param batchId - Optional batch ID hint to help server disambiguate if digest appears in multiple batches
- * @param client - Optional pre-configured ZipstampServerClient instance (useful for polling with custom timeout/retry settings)
+ * @param client - Optional pre-configured TokenServiceClient instance (useful for polling with custom timeout/retry settings)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to verification response with status and blockchain details
  *
@@ -132,11 +152,11 @@ async function verifyDigest(digest, chainId, batchId, client, options) {
     const c = client ?? getClient(options);
     const reqBody = { digest, chainId, batchId };
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /verify request:', JSON.stringify(reqBody, null, 2));
+        console.log('[TokenService] POST /verify request:', JSON.stringify(reqBody, null, 2));
     }
     const res = await c.verify(reqBody);
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /verify response:', JSON.stringify(res, null, 2));
+        console.log('[TokenService] POST /verify response:', JSON.stringify(res, null, 2));
     }
     return {
         success: res.success,
@@ -158,9 +178,9 @@ async function verifyDigest(digest, chainId, batchId, client, options) {
     };
 }
 /**
- * Polls the Zipstamp server for confirmation of a digest.
+ * Polls the NeoZip Token Service for confirmation of a digest.
  *
- * Continuously checks the Zipstamp server API until the digest is confirmed on the
+ * Continuously checks the NeoZip Token Service API until the digest is confirmed on the
  * blockchain or the timeout is reached. Uses deadline-aware polling with per-request
  * timeouts to ensure proper exit behavior.
  *
@@ -175,7 +195,7 @@ async function verifyDigest(digest, chainId, batchId, client, options) {
  * @param timeout - Maximum time to poll in milliseconds (default: 300000 = 5 minutes)
  * @param interval - Time between polling attempts in milliseconds (default: 5000 = 5 seconds)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to verification response if confirmed, or `null` if timeout reached
  *
@@ -204,7 +224,7 @@ async function verifyDigest(digest, chainId, batchId, client, options) {
 async function pollForConfirmation(digest, chainId, batchId, timeout = 300000, // 5 minutes default
 interval = 5000, // 5 seconds default
 options) {
-    const serverUrl = (0, servers_1.getZipStampServerUrl)(options);
+    const serverUrl = (0, servers_1.getTokenServiceUrl)(options);
     let attempts = 0;
     const startTime = Date.now();
     const deadline = startTime + timeout;
@@ -217,13 +237,13 @@ options) {
         attempts++;
         const elapsed = now - startTime;
         if (shouldDebug(options)) {
-            console.log(`[Zipstamp Server API] pollForConfirmation attempt=${attempts} elapsedMs=${elapsed} remainingMs=${remaining}`);
+            console.log(`[TokenService] pollForConfirmation attempt=${attempts} elapsedMs=${elapsed} remainingMs=${remaining}`);
         }
         try {
             // Ensure a single /verify call cannot exceed the overall poll timeout.
             // Also disable retries during polling so the deadline is honored.
             const perRequestTimeoutMs = Math.max(1000, Math.min(30000, remaining));
-            const client = new ZipstampServerClient_1.ZipstampServerClient({
+            const client = new TokenServiceClient_1.TokenServiceClient({
                 serverUrl,
                 timeout: perRequestTimeoutMs,
                 retries: 0,
@@ -252,7 +272,7 @@ options) {
         }
         catch (error) {
             if (shouldDebug(options)) {
-                console.log(`[Zipstamp Server API] pollForConfirmation verify error: ${error instanceof Error ? error.message : String(error)}`);
+                console.log(`[TokenService] pollForConfirmation verify error: ${error instanceof Error ? error.message : String(error)}`);
             }
             // On error, wait and retry
             const sleepMs = Math.min(interval, Math.max(0, deadline - Date.now()));
@@ -279,7 +299,7 @@ options) {
  * @param chainId - Optional chain ID hint
  * @param batchId - Optional batch ID from TIMESTAMP.NZIP metadata to ensure the correct batch is used
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to mint data response containing all parameters needed for contract call
  *
@@ -309,14 +329,14 @@ async function prepareMint(digest, chainId, batchId, options) {
 /**
  * Checks if a digest has already been minted as an NFT proof token.
  *
- * Queries the Zipstamp server to determine if a digest has been minted as an NFT
+ * Queries the NeoZip Token Service to determine if a digest has been minted as an NFT
  * on the TimestampProofNFT contract. Returns token information if minted, including
  * token ID, owner, and proof data.
  *
  * @param digest - The SHA-256 digest (64-character hex string) to check
  * @param chainId - Optional chain ID hint
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to NFT status response indicating if minted and token details
  *
@@ -338,14 +358,14 @@ async function checkNFTStatus(digest, chainId, options) {
     return client.checkNFTStatus(digest, chainId);
 }
 /**
- * Retrieves NFT contract information from the Zipstamp server.
+ * Retrieves NFT contract information from the NeoZip Token Service.
  *
  * Gets details about the TimestampProofNFT contract for a given network,
  * including contract address, registry address, minting fee, and version.
  *
  * @param chainId - Optional chain ID hint (if not provided, server uses default network)
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL (defaults to `ZIPSTAMP_SERVER_URL` env var or `https://zipstamp-dev.neozip.io`)
+ * @param options.serverUrl - NeoZip Token Service URL (defaults to `TOKEN_SERVICE_URL` env var or `https://testnet.token-service.neozip.io`)
  * @param options.debug - Enable debug logging (defaults to `false`)
  * @returns Promise resolving to contract information response
  *
@@ -376,7 +396,8 @@ async function getNFTContractInfo(chainId, options) {
  *
  * @param email - Email address to register
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
+ * @param options.verificationDelivery - `browser` (default) or `app`; matches token service `POST /auth/register`
  * @returns Promise resolving to registration response
  *
  * @example
@@ -392,12 +413,16 @@ async function getNFTContractInfo(chainId, options) {
  */
 async function registerEmail(email, options) {
     const client = getClient(options);
+    const payload = { email };
+    if (options?.verificationDelivery !== undefined) {
+        payload.verificationDelivery = options.verificationDelivery;
+    }
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /auth/register request:', { email });
+        console.log('[TokenService] POST /auth/register request:', payload);
     }
-    const result = await client.register({ email });
+    const result = await client.register(payload);
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /auth/register response:', JSON.stringify(result, null, 2));
+        console.log('[TokenService] POST /auth/register response:', JSON.stringify(result, null, 2));
     }
     return result;
 }
@@ -414,17 +439,17 @@ async function registerEmail(email, options) {
  * @param email - Email address that was registered
  * @param code - Verification code from email
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @returns Promise resolving to verification response
  */
 async function verifyEmailCode(email, code, options) {
     const client = getClient(options);
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /auth/verify request:', { email, code: '***' });
+        console.log('[TokenService] POST /auth/verify request:', { email, code: '***' });
     }
     const result = await client.verifyEmail({ email, code });
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] POST /auth/verify response:', JSON.stringify(result, null, 2));
+        console.log('[TokenService] POST /auth/verify response:', JSON.stringify(result, null, 2));
     }
     return result;
 }
@@ -437,7 +462,7 @@ async function verifyEmailCode(email, code, options) {
  * PUBLIC: No API key required.
  *
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @returns Promise resolving to calendar identity information
  *
  * @example
@@ -454,11 +479,11 @@ async function verifyEmailCode(email, code, options) {
 async function getCalendarIdentity(options) {
     const client = getClient(options);
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] GET /calendar');
+        console.log('[TokenService] GET /calendar');
     }
     const result = await client.getCalendar();
     if (shouldDebug(options)) {
-        console.log('[Zipstamp Server API] GET /calendar response:', JSON.stringify(result, null, 2));
+        console.log('[TokenService] GET /calendar response:', JSON.stringify(result, null, 2));
     }
     return result;
 }
@@ -471,7 +496,7 @@ async function getCalendarIdentity(options) {
  * PUBLIC: No API key required.
  *
  * @param options - Optional configuration
- * @param options.serverUrl - Zipstamp server URL
+ * @param options.serverUrl - NeoZip Token Service URL
  * @param full - If true, returns detailed component health (default: false)
  * @returns Promise resolving to health check response
  *
@@ -492,12 +517,12 @@ async function checkCalendarHealth(options, full = false) {
     const client = getClient(options);
     const endpoint = full ? '/health/full' : '/health';
     if (shouldDebug(options)) {
-        console.log(`[Zipstamp Server API] GET ${endpoint}`);
+        console.log(`[TokenService] GET ${endpoint}`);
     }
     const result = full ? await client.healthCheckFull() : await client.healthCheck();
     if (shouldDebug(options)) {
-        console.log(`[Zipstamp Server API] GET ${endpoint} response:`, JSON.stringify(result, null, 2));
+        console.log(`[TokenService] GET ${endpoint} response:`, JSON.stringify(result, null, 2));
     }
     return result;
 }
-//# sourceMappingURL=ZipstampServerHelpers.js.map
+//# sourceMappingURL=TokenServiceHelpers.js.map