@wishknish/knishio-client-ts 0.9.3 → 0.9.5

package/dist/index.js

@@ -3833,6 +3833,14 @@ var Wallet = class _Wallet {
 };
 var hexStringRegex = /^[0-9a-fA-F]+$/;
 var base17HashRegex = /^[0-9a-g]+$/;
+var urlString = (message = "Invalid URL") => z.string().refine((value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}, message);
 z.string().regex(hexStringRegex, "Must be a valid hexadecimal string").brand();
 var WalletAddressSchema = z.string().regex(hexStringRegex, "Wallet address must be hexadecimal").length(64, "Wallet address must be exactly 64 characters").brand();
 var BundleHashSchema = z.string().regex(hexStringRegex, "Bundle hash must be hexadecimal").length(64, "Bundle hash must be exactly 64 characters").brand();
@@ -3844,7 +3852,7 @@ var MetaIdSchema = z.string().min(1, "Meta ID cannot be empty").brand();
 var BatchIdSchema = z.string().min(1, "Batch ID cannot be empty").brand();
 var CellSlugSchema = z.string().min(1, "Cell slug cannot be empty").max(64, "Cell slug cannot exceed 64 characters").brand();
 var AtomIsotopeSchema = z.enum(["C", "V", "U", "T", "M", "I", "R", "B", "F"], {
-  errorMap: () => ({ message: "Invalid atom isotope. Must be one of: C, V, U, T, M, I, R, B, F" })
+  error: "Invalid atom isotope. Must be one of: C, V, U, T, M, I, R, B, F"
 });
 var MetaDataValueSchema = z.union([
   z.string(),
@@ -3857,7 +3865,7 @@ var AtomMetaDataSchema = z.object({
   value: MetaDataValueSchema
 }).strict();
 var MetaDataSchema = z.lazy(
-  () => z.record(z.union([
+  () => z.record(z.string(), z.union([
     MetaDataValueSchema,
     MetaDataSchema,
     z.array(MetaDataSchema)
@@ -3896,7 +3904,7 @@ z.object({
   version: z.number().int().min(1).optional()
 }).strict();
 z.object({
-  uri: z.union([z.string().url(), z.array(z.string().url())]).optional(),
+  uri: z.union([urlString(), z.array(urlString())]).optional(),
   cellSlug: z.union([CellSlugSchema, z.string(), z.null()]).optional(),
   client: z.unknown().optional(),
   socket: z.unknown().optional(),
@@ -3913,7 +3921,7 @@ z.object({
 z.object({
   cellSlug: z.union([CellSlugSchema, z.string(), z.null()]).optional(),
   encrypt: z.boolean().optional(),
-  callback: z.function().args(z.unknown()).returns(z.void()).optional()
+  callback: z.custom((value) => typeof value === "function").optional()
 }).strict();
 z.object({
   cellSlug: z.union([CellSlugSchema, z.string(), z.null()]).optional()
@@ -3922,7 +3930,7 @@ z.object({
   recipient: z.union([WalletAddressSchema, z.string()]),
   amount: z.union([z.number().positive(), z.string().min(1)]),
   token: z.union([TokenSlugSchema, z.string()]).optional(),
-  callbackUrl: z.union([z.string().url(), z.null()]).optional(),
+  callbackUrl: z.union([urlString(), z.null()]).optional(),
   metaType: z.union([MetaTypeSchema, z.string(), z.null()]).optional(),
   metaId: z.union([MetaIdSchema, z.string(), z.null()]).optional(),
   meta: z.union([MetaDataSchema, z.null()]).optional()
@@ -3963,7 +3971,7 @@ z.object({
   value: z.union([z.string(), z.null()]).optional(),
   latest: z.union([z.boolean(), z.null()]).optional(),
   filter: z.union([z.array(MetaFilterSchema), z.null()]).optional(),
-  queryArgs: z.union([z.record(z.unknown()), z.null()]).optional(),
+  queryArgs: z.union([z.record(z.string(), z.unknown()), z.null()]).optional(),
   count: z.union([z.number().int().min(1), z.null()]).optional(),
   countBy: z.union([z.string(), z.null()]).optional(),
   cellSlug: z.union([CellSlugSchema, z.string(), z.null()]).optional()
@@ -3988,7 +3996,7 @@ z.object({
 }).strict();
 z.object({
   query: z.string().min(1, "GraphQL query cannot be empty"),
-  variables: z.record(z.unknown()).optional(),
+  variables: z.record(z.string(), z.unknown()).optional(),
   operationName: z.union([z.string(), z.null()]).optional()
 }).strict();
 var GraphQLErrorSchema = z.object({
@@ -3998,18 +4006,18 @@ var GraphQLErrorSchema = z.object({
     column: z.number().int().min(1)
   })).optional(),
   path: z.array(z.union([z.string(), z.number()])).optional(),
-  extensions: z.record(z.unknown()).optional()
+  extensions: z.record(z.string(), z.unknown()).optional()
 }).strict();
 z.object({
   data: z.unknown().optional(),
   errors: z.array(GraphQLErrorSchema).nullable().optional(),
-  extensions: z.record(z.unknown()).optional()
+  extensions: z.record(z.string(), z.unknown()).optional()
 }).strict();
 z.object({
   operationName: z.string().optional(),
   query: z.string().optional(),
-  variables: z.record(z.unknown()).optional(),
-  callback: z.function().args(z.unknown()).returns(z.void()).optional()
+  variables: z.record(z.string(), z.unknown()).optional(),
+  callback: z.custom((value) => typeof value === "function").optional()
 }).strict();
 z.object({
   valid: z.boolean(),
@@ -4019,7 +4027,7 @@ z.object({
 }).strict();
 z.object({
   operation: z.string().optional(),
-  parameters: z.record(z.unknown()).optional(),
+  parameters: z.record(z.string(), z.unknown()).optional(),
   timestamp: z.number().int().min(0).optional(),
   stack: z.string().optional()
 }).strict();
@@ -4223,7 +4231,7 @@ var CallbackParamsSchema = z.object({
   action: z.string().min(1, "Action cannot be empty"),
   metaType: z.union([z.string(), z.null()]).optional(),
   metaId: z.union([z.string(), z.null()]).optional(),
-  meta: z.union([z.instanceof(Meta2), z.record(z.unknown()), z.null()]).optional(),
+  meta: z.union([z.instanceof(Meta2), z.record(z.string(), z.unknown()), z.null()]).optional(),
   address: z.union([z.string(), z.null()]).optional(),
   token: z.union([z.string(), z.null()]).optional(),
   amount: z.union([z.string(), z.null()]).optional(),
@@ -4487,7 +4495,7 @@ var CheckMolecule = class _CheckMolecule {
    * @return True if all validations pass
    */
   verify(senderWallet) {
-    return this.molecularHash() && this.ots() && this.batchId() && this.continuId() && this.isotopeM() && this.isotopeT() && this.isotopeC() && this.isotopeU() && this.isotopeI() && this.isotopeR() && this.isotopeV(senderWallet || null);
+    return this.molecularHash() && this.ots() && this.batchId() && this.continuId() && this.isotopeM() && this.isotopeT() && this.isotopeC() && this.isotopeU() && this.isotopeI() && this.isotopeR() && this.isotopeP() && this.isotopeA() && this.isotopeB() && this.isotopeF() && this.isotopeV(senderWallet || null);
   }
   /**
    * Validate ContinuID requirement
@@ -4675,6 +4683,141 @@ var CheckMolecule = class _CheckMolecule {
     }
     return true;
   }
+  /**
+   * Validate isotope P atoms (peering)
+   * @return True if valid
+   * @throws WrongTokenTypeException if the token slug is not USER
+   * @throws MetaMissingException if the required peerHost meta field is absent
+   */
+  isotopeP() {
+    for (const atom of this.molecule.getIsotopes("P")) {
+      if (atom.token !== "USER") {
+        throw new WrongTokenTypeException(`Check::isotopeP() - "${atom.token}" is not a valid Token slug for "${atom.isotope}" isotope Atoms!`);
+      }
+      const metas = atom.aggregatedMeta();
+      if (!Object.prototype.hasOwnProperty.call(metas, "peerHost") || !metas.peerHost) {
+        throw new MetaMissingException('Check::isotopeP() - Required meta field "peerHost" is missing!');
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope A atoms (append request)
+   * @return True if valid
+   * @throws WrongTokenTypeException if the token slug is not USER
+   * @throws MetaMissingException if metaType, metaId or the action meta field is absent
+   */
+  isotopeA() {
+    for (const atom of this.molecule.getIsotopes("A")) {
+      if (atom.token !== "USER") {
+        throw new WrongTokenTypeException(`Check::isotopeA() - "${atom.token}" is not a valid Token slug for "${atom.isotope}" isotope Atoms!`);
+      }
+      if (!atom.metaType) {
+        throw new MetaMissingException('Check::isotopeA() - Required field "metaType" is missing!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException('Check::isotopeA() - Required field "metaId" is missing!');
+      }
+      const metas = atom.aggregatedMeta();
+      if (!Object.prototype.hasOwnProperty.call(metas, "action") || !metas.action) {
+        throw new MetaMissingException('Check::isotopeA() - Required meta field "action" is missing!');
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope B atoms (buffer/exchange)
+   *
+   * Buffer molecules are cross-isotope: their V atoms do not balance on their own
+   * because a B atom absorbs the difference. isotopeV() therefore skips its V-only
+   * conservation checks whenever B (or F) atoms are present, and conservation is
+   * enforced here instead over the combined V+B set.
+   *
+   * @return True if valid
+   * @throws MetaMissingException if metaType is not walletBundle, or metaId is absent
+   * @throws TransferMalformedException if a B atom value is not a number
+   * @throws TransferUnbalancedException if V+B atom values do not sum to zero
+   */
+  isotopeB() {
+    const isotopeB = this.molecule.getIsotopes("B");
+    if (isotopeB.length === 0) {
+      return true;
+    }
+    for (const atom of isotopeB) {
+      if (!atom.metaType || atom.metaType !== "walletBundle") {
+        throw new MetaMissingException('Check::isotopeB() - B-isotope atoms must have metaType "walletBundle"!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException("Check::isotopeB() - B-isotope atoms must have a metaId!");
+      }
+      const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+      if (Number.isNaN(value)) {
+        throw new TransferMalformedException("Check::isotopeB() - B-isotope atom value is not a valid number!");
+      }
+    }
+    const vAtoms = this.molecule.getIsotopes("V");
+    if (vAtoms.length > 0) {
+      let sum = 0;
+      for (const atom of [...vAtoms, ...isotopeB]) {
+        const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+        if (!Number.isNaN(value)) {
+          sum += value;
+        }
+      }
+      if (sum !== 0) {
+        throw new TransferUnbalancedException("Check::isotopeB() - V+B atom values do not balance to zero!");
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope F atoms (fusion/NFT)
+   *
+   * Mirrors isotopeB() and additionally forbids negative values. Must stay paired
+   * with the hasCrossIsotope gate in isotopeV(), which is keyed on B *or* F: without
+   * this check an F-isotope molecule would skip V-only conservation with nothing
+   * validating V+F conservation in its place.
+   *
+   * @return True if valid
+   * @throws MetaMissingException if metaType is not walletBundle, or metaId is absent
+   * @throws TransferMalformedException if an F atom value is not a number, or is negative
+   * @throws TransferUnbalancedException if V+F atom values do not sum to zero
+   */
+  isotopeF() {
+    const isotopeF = this.molecule.getIsotopes("F");
+    if (isotopeF.length === 0) {
+      return true;
+    }
+    for (const atom of isotopeF) {
+      if (!atom.metaType || atom.metaType !== "walletBundle") {
+        throw new MetaMissingException('Check::isotopeF() - F-isotope atoms must have metaType "walletBundle"!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException("Check::isotopeF() - F-isotope atoms must have a metaId!");
+      }
+      const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+      if (Number.isNaN(value)) {
+        throw new TransferMalformedException("Check::isotopeF() - F-isotope atom value is not a valid number!");
+      }
+      if (value < 0) {
+        throw new TransferMalformedException("Check::isotopeF() - F-isotope atom value must not be negative!");
+      }
+    }
+    const vAtoms = this.molecule.getIsotopes("V");
+    if (vAtoms.length > 0) {
+      let sum = 0;
+      for (const atom of [...vAtoms, ...isotopeF]) {
+        const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+        if (!Number.isNaN(value)) {
+          sum += value;
+        }
+      }
+      if (sum !== 0) {
+        throw new TransferUnbalancedException("Check::isotopeF() - V+F atom values do not balance to zero!");
+      }
+    }
+    return true;
+  }
   /**
    * Validate isotope V atoms (value transfers)
    * @param senderWallet - Optional wallet for balance validation
@@ -4686,11 +4829,12 @@ var CheckMolecule = class _CheckMolecule {
     if (isotopeV.length === 0) {
       return true;
     }
+    const hasCrossIsotope = this.molecule.getIsotopes("B").length > 0 || this.molecule.getIsotopes("F").length > 0;
     const firstAtom = this.molecule.atoms[0];
     if (!firstAtom) {
       throw new AtomsMissingException("Check::isotopeV() - Missing first atom");
     }
-    if (firstAtom.isotope === "V" && isotopeV.length === 2) {
+    if (!hasCrossIsotope && firstAtom.isotope === "V" && isotopeV.length === 2) {
       const endAtom = isotopeV[isotopeV.length - 1];
       if (!endAtom) {
         throw new AtomsMissingException("Check::isotopeV() - Missing end atom");
@@ -4702,6 +4846,10 @@ var CheckMolecule = class _CheckMolecule {
       if (endValue < 0) {
         throw new TransferMalformedException();
       }
+      const firstValueForPair = firstAtom.value !== null ? Number(firstAtom.value) : 0;
+      if (firstValueForPair + endValue !== 0) {
+        throw new TransferUnbalancedException();
+      }
       return true;
     }
     let sum = 0;
@@ -4730,7 +4878,7 @@ var CheckMolecule = class _CheckMolecule {
         sum += value;
       }
     }
-    if (sum !== 0) {
+    if (!hasCrossIsotope && sum !== 0) {
       throw new TransferUnbalancedException();
     }
     if (senderWallet) {
@@ -4742,7 +4890,7 @@ var CheckMolecule = class _CheckMolecule {
       if (remainder < 0) {
         throw new TransferBalanceException();
       }
-      if (remainder !== sum) {
+      if (!hasCrossIsotope && remainder !== sum) {
         throw new TransferRemainderException();
       }
     } else if (sum !== 0) {
@@ -6430,6 +6578,14 @@ var Mutation = class extends Query {
     }
   }
 };
+var urlString2 = (message = "Invalid URL") => z.string().refine((value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}, message);
 function createBrandedSchema(name, baseSchema = z.string()) {
   return baseSchema.brand(name);
 }
@@ -6455,7 +6611,12 @@ var TokenSlugSchema2 = createBrandedSchema(
 );
 var BatchIdSchema2 = createBrandedSchema(
   "BatchId",
-  z.string().uuid("Invalid batch ID format")
+  // v3's `.uuid()` regex, inlined verbatim. Zod 4's `z.uuid()` additionally enforces the
+  // RFC 9562 version/variant nibbles and would reject batch IDs v3 accepted.
+  z.string().regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Invalid batch ID format"
+  )
 );
 var CellSlugSchema2 = createBrandedSchema(
   "CellSlug",
@@ -6499,7 +6660,7 @@ var AtomMetaDataSchema2 = z.object({
 z.object({
   key: z.string(),
   value: z.union([z.string(), z.number(), z.boolean(), z.null()])
-}).passthrough();
+}).loose();
 var AtomParamsSchema2 = z.object({
   position: z.string().optional(),
   walletAddress: z.union([WalletAddressSchema2, z.string()]).optional(),
@@ -6534,8 +6695,8 @@ var MoleculeParamsSchema2 = z.object({
 }).strict();
 var KnishIOClientConfigSchema2 = z.object({
   uri: z.union([
-    z.string().url("Invalid URI format"),
-    z.array(z.string().url("Invalid URI format")).min(1)
+    urlString2("Invalid URI format"),
+    z.array(urlString2("Invalid URI format")).min(1)
   ]).optional(),
   cellSlug: z.union([CellSlugSchema2, z.string()]).optional(),
   client: z.unknown().optional(),
@@ -6548,11 +6709,11 @@ var KnishIOClientConfigSchema2 = z.object({
   defaultRequestPolicy: z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 var EnvironmentConfigSchema = z.object({
-  NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
-  KNISHIO_NODE_URI: z.string().url().optional(),
+  NODE_ENV: z.enum(["development", "production", "test"]).optional(),
+  KNISHIO_NODE_URI: urlString2().optional(),
   KNISHIO_CELL_SLUG: z.string().optional(),
-  KNISHIO_LOGGING: z.string().transform((val) => val === "true").default("false"),
-  KNISHIO_SERVER_SDK_VERSION: z.string().transform((val) => parseInt(val, 10)).default("4")
+  KNISHIO_LOGGING: z.string().transform((val) => val === "true").optional(),
+  KNISHIO_SERVER_SDK_VERSION: z.string().transform((val) => parseInt(val, 10)).optional()
 }).partial();
 var TransferParamsSchema2 = z.object({
   recipient: z.union([WalletAddressSchema2, z.string()]),
@@ -6561,7 +6722,7 @@ var TransferParamsSchema2 = z.object({
     "Amount must be positive"
   ),
   token: z.union([TokenSlugSchema2, z.string()]).optional(),
-  callbackUrl: z.string().url().optional(),
+  callbackUrl: urlString2().optional(),
   metaType: z.string().optional(),
   metaId: z.string().optional(),
   meta: MetaDataSchema2.optional()
@@ -6602,7 +6763,7 @@ var MetaQueryParamsSchema2 = z.object({
   value: z.string().optional(),
   latest: z.boolean().optional(),
   filter: z.string().optional(),
-  queryArgs: z.record(z.unknown()).optional(),
+  queryArgs: z.record(z.string(), z.unknown()).optional(),
   count: z.number().int().min(0).optional(),
   countBy: z.string().optional(),
   cellSlug: z.union([CellSlugSchema2, z.string()]).optional()
@@ -6621,14 +6782,14 @@ var AuthTokenParamsSchema2 = z.object({
 var AuthParamsSchema2 = z.object({
   cellSlug: z.union([CellSlugSchema2, z.string()]).optional(),
   encrypt: z.boolean().optional(),
-  callback: z.function().optional()
+  callback: z.custom((value) => typeof value === "function").optional()
 }).strict();
 var GuestAuthParamsSchema2 = z.object({
   cellSlug: z.union([CellSlugSchema2, z.string()]).optional()
 }).strict();
 var GraphQLRequestSchema2 = z.object({
   query: z.string().min(1),
-  variables: z.record(z.unknown()).optional(),
+  variables: z.record(z.string(), z.unknown()).optional(),
   operationName: z.string().optional()
 }).strict();
 var GraphQLErrorSchema2 = z.object({
@@ -6638,12 +6799,12 @@ var GraphQLErrorSchema2 = z.object({
     column: z.number().int()
   })).optional(),
   path: z.array(z.union([z.string(), z.number()])).optional(),
-  extensions: z.record(z.unknown()).optional()
+  extensions: z.record(z.string(), z.unknown()).optional()
 }).strict();
 var GraphQLResponseSchema2 = z.object({
   data: z.unknown().optional(),
   errors: z.array(GraphQLErrorSchema2).optional(),
-  extensions: z.record(z.unknown()).optional()
+  extensions: z.record(z.string(), z.unknown()).optional()
 }).strict();
 function safeParse(schema, data) {
   const result = schema.safeParse(data);
@@ -6653,7 +6814,7 @@ function safeParse(schema, data) {
       error: {
         issues: result.error.issues,
         message: result.error.message,
-        formatted: result.error.format()
+        formatted: z.treeifyError(result.error)
       }
     };
   }
@@ -11914,7 +12075,7 @@ var PolicyMeta = class _PolicyMeta {
 
 // src/index.ts
 init_exception();
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "0.9.5";
 var SDK_NAME = "KnishIO-Client-TS";
 var COMPATIBLE_SERVER_VERSIONS = [4, 5];
 var SDK_INFO = {