@wishknish/knishio-client-ts 0.9.3 → 0.9.5

package/dist/index.cjs

@@ -3839,6 +3839,14 @@ var Wallet = class _Wallet {
 };
 var hexStringRegex = /^[0-9a-fA-F]+$/;
 var base17HashRegex = /^[0-9a-g]+$/;
+var urlString = (message = "Invalid URL") => zod.z.string().refine((value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}, message);
 zod.z.string().regex(hexStringRegex, "Must be a valid hexadecimal string").brand();
 var WalletAddressSchema = zod.z.string().regex(hexStringRegex, "Wallet address must be hexadecimal").length(64, "Wallet address must be exactly 64 characters").brand();
 var BundleHashSchema = zod.z.string().regex(hexStringRegex, "Bundle hash must be hexadecimal").length(64, "Bundle hash must be exactly 64 characters").brand();
@@ -3850,7 +3858,7 @@ var MetaIdSchema = zod.z.string().min(1, "Meta ID cannot be empty").brand();
 var BatchIdSchema = zod.z.string().min(1, "Batch ID cannot be empty").brand();
 var CellSlugSchema = zod.z.string().min(1, "Cell slug cannot be empty").max(64, "Cell slug cannot exceed 64 characters").brand();
 var AtomIsotopeSchema = zod.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 = zod.z.union([
   zod.z.string(),
@@ -3863,7 +3871,7 @@ var AtomMetaDataSchema = zod.z.object({
   value: MetaDataValueSchema
 }).strict();
 var MetaDataSchema = zod.z.lazy(
-  () => zod.z.record(zod.z.union([
+  () => zod.z.record(zod.z.string(), zod.z.union([
     MetaDataValueSchema,
     MetaDataSchema,
     zod.z.array(MetaDataSchema)
@@ -3902,7 +3910,7 @@ zod.z.object({
   version: zod.z.number().int().min(1).optional()
 }).strict();
 zod.z.object({
-  uri: zod.z.union([zod.z.string().url(), zod.z.array(zod.z.string().url())]).optional(),
+  uri: zod.z.union([urlString(), zod.z.array(urlString())]).optional(),
   cellSlug: zod.z.union([CellSlugSchema, zod.z.string(), zod.z.null()]).optional(),
   client: zod.z.unknown().optional(),
   socket: zod.z.unknown().optional(),
@@ -3919,7 +3927,7 @@ zod.z.object({
 zod.z.object({
   cellSlug: zod.z.union([CellSlugSchema, zod.z.string(), zod.z.null()]).optional(),
   encrypt: zod.z.boolean().optional(),
-  callback: zod.z.function().args(zod.z.unknown()).returns(zod.z.void()).optional()
+  callback: zod.z.custom((value) => typeof value === "function").optional()
 }).strict();
 zod.z.object({
   cellSlug: zod.z.union([CellSlugSchema, zod.z.string(), zod.z.null()]).optional()
@@ -3928,7 +3936,7 @@ zod.z.object({
   recipient: zod.z.union([WalletAddressSchema, zod.z.string()]),
   amount: zod.z.union([zod.z.number().positive(), zod.z.string().min(1)]),
   token: zod.z.union([TokenSlugSchema, zod.z.string()]).optional(),
-  callbackUrl: zod.z.union([zod.z.string().url(), zod.z.null()]).optional(),
+  callbackUrl: zod.z.union([urlString(), zod.z.null()]).optional(),
   metaType: zod.z.union([MetaTypeSchema, zod.z.string(), zod.z.null()]).optional(),
   metaId: zod.z.union([MetaIdSchema, zod.z.string(), zod.z.null()]).optional(),
   meta: zod.z.union([MetaDataSchema, zod.z.null()]).optional()
@@ -3969,7 +3977,7 @@ zod.z.object({
   value: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
   latest: zod.z.union([zod.z.boolean(), zod.z.null()]).optional(),
   filter: zod.z.union([zod.z.array(MetaFilterSchema), zod.z.null()]).optional(),
-  queryArgs: zod.z.union([zod.z.record(zod.z.unknown()), zod.z.null()]).optional(),
+  queryArgs: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), zod.z.null()]).optional(),
   count: zod.z.union([zod.z.number().int().min(1), zod.z.null()]).optional(),
   countBy: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
   cellSlug: zod.z.union([CellSlugSchema, zod.z.string(), zod.z.null()]).optional()
@@ -3994,7 +4002,7 @@ zod.z.object({
 }).strict();
 zod.z.object({
   query: zod.z.string().min(1, "GraphQL query cannot be empty"),
-  variables: zod.z.record(zod.z.unknown()).optional(),
+  variables: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   operationName: zod.z.union([zod.z.string(), zod.z.null()]).optional()
 }).strict();
 var GraphQLErrorSchema = zod.z.object({
@@ -4004,18 +4012,18 @@ var GraphQLErrorSchema = zod.z.object({
     column: zod.z.number().int().min(1)
   })).optional(),
   path: zod.z.array(zod.z.union([zod.z.string(), zod.z.number()])).optional(),
-  extensions: zod.z.record(zod.z.unknown()).optional()
+  extensions: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 }).strict();
 zod.z.object({
   data: zod.z.unknown().optional(),
   errors: zod.z.array(GraphQLErrorSchema).nullable().optional(),
-  extensions: zod.z.record(zod.z.unknown()).optional()
+  extensions: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 }).strict();
 zod.z.object({
   operationName: zod.z.string().optional(),
   query: zod.z.string().optional(),
-  variables: zod.z.record(zod.z.unknown()).optional(),
-  callback: zod.z.function().args(zod.z.unknown()).returns(zod.z.void()).optional()
+  variables: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  callback: zod.z.custom((value) => typeof value === "function").optional()
 }).strict();
 zod.z.object({
   valid: zod.z.boolean(),
@@ -4025,7 +4033,7 @@ zod.z.object({
 }).strict();
 zod.z.object({
   operation: zod.z.string().optional(),
-  parameters: zod.z.record(zod.z.unknown()).optional(),
+  parameters: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   timestamp: zod.z.number().int().min(0).optional(),
   stack: zod.z.string().optional()
 }).strict();
@@ -4229,7 +4237,7 @@ var CallbackParamsSchema = zod.z.object({
   action: zod.z.string().min(1, "Action cannot be empty"),
   metaType: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
   metaId: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
-  meta: zod.z.union([zod.z.instanceof(Meta2), zod.z.record(zod.z.unknown()), zod.z.null()]).optional(),
+  meta: zod.z.union([zod.z.instanceof(Meta2), zod.z.record(zod.z.string(), zod.z.unknown()), zod.z.null()]).optional(),
   address: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
   token: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
   amount: zod.z.union([zod.z.string(), zod.z.null()]).optional(),
@@ -4493,7 +4501,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
@@ -4681,6 +4689,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
@@ -4692,11 +4835,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 exports.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 exports.AtomsMissingException("Check::isotopeV() - Missing end atom");
@@ -4708,6 +4852,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;
@@ -4736,7 +4884,7 @@ var CheckMolecule = class _CheckMolecule {
         sum += value;
       }
     }
-    if (sum !== 0) {
+    if (!hasCrossIsotope && sum !== 0) {
       throw new TransferUnbalancedException();
     }
     if (senderWallet) {
@@ -4748,7 +4896,7 @@ var CheckMolecule = class _CheckMolecule {
       if (remainder < 0) {
         throw new exports.TransferBalanceException();
       }
-      if (remainder !== sum) {
+      if (!hasCrossIsotope && remainder !== sum) {
         throw new TransferRemainderException();
       }
     } else if (sum !== 0) {
@@ -6436,6 +6584,14 @@ var Mutation = class extends Query {
     }
   }
 };
+var urlString2 = (message = "Invalid URL") => zod.z.string().refine((value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}, message);
 function createBrandedSchema(name, baseSchema = zod.z.string()) {
   return baseSchema.brand(name);
 }
@@ -6461,7 +6617,12 @@ var TokenSlugSchema2 = createBrandedSchema(
 );
 var BatchIdSchema2 = createBrandedSchema(
   "BatchId",
-  zod.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.
+  zod.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",
@@ -6505,7 +6666,7 @@ var AtomMetaDataSchema2 = zod.z.object({
 zod.z.object({
   key: zod.z.string(),
   value: zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean(), zod.z.null()])
-}).passthrough();
+}).loose();
 var AtomParamsSchema2 = zod.z.object({
   position: zod.z.string().optional(),
   walletAddress: zod.z.union([WalletAddressSchema2, zod.z.string()]).optional(),
@@ -6540,8 +6701,8 @@ var MoleculeParamsSchema2 = zod.z.object({
 }).strict();
 var KnishIOClientConfigSchema2 = zod.z.object({
   uri: zod.z.union([
-    zod.z.string().url("Invalid URI format"),
-    zod.z.array(zod.z.string().url("Invalid URI format")).min(1)
+    urlString2("Invalid URI format"),
+    zod.z.array(urlString2("Invalid URI format")).min(1)
   ]).optional(),
   cellSlug: zod.z.union([CellSlugSchema2, zod.z.string()]).optional(),
   client: zod.z.unknown().optional(),
@@ -6554,11 +6715,11 @@ var KnishIOClientConfigSchema2 = zod.z.object({
   defaultRequestPolicy: zod.z.enum(["cache-first", "cache-only", "network-only", "cache-and-network"]).nullable().optional()
 }).strict();
 var EnvironmentConfigSchema = zod.z.object({
-  NODE_ENV: zod.z.enum(["development", "production", "test"]).default("development"),
-  KNISHIO_NODE_URI: zod.z.string().url().optional(),
+  NODE_ENV: zod.z.enum(["development", "production", "test"]).optional(),
+  KNISHIO_NODE_URI: urlString2().optional(),
   KNISHIO_CELL_SLUG: zod.z.string().optional(),
-  KNISHIO_LOGGING: zod.z.string().transform((val) => val === "true").default("false"),
-  KNISHIO_SERVER_SDK_VERSION: zod.z.string().transform((val) => parseInt(val, 10)).default("4")
+  KNISHIO_LOGGING: zod.z.string().transform((val) => val === "true").optional(),
+  KNISHIO_SERVER_SDK_VERSION: zod.z.string().transform((val) => parseInt(val, 10)).optional()
 }).partial();
 var TransferParamsSchema2 = zod.z.object({
   recipient: zod.z.union([WalletAddressSchema2, zod.z.string()]),
@@ -6567,7 +6728,7 @@ var TransferParamsSchema2 = zod.z.object({
     "Amount must be positive"
   ),
   token: zod.z.union([TokenSlugSchema2, zod.z.string()]).optional(),
-  callbackUrl: zod.z.string().url().optional(),
+  callbackUrl: urlString2().optional(),
   metaType: zod.z.string().optional(),
   metaId: zod.z.string().optional(),
   meta: MetaDataSchema2.optional()
@@ -6608,7 +6769,7 @@ var MetaQueryParamsSchema2 = zod.z.object({
   value: zod.z.string().optional(),
   latest: zod.z.boolean().optional(),
   filter: zod.z.string().optional(),
-  queryArgs: zod.z.record(zod.z.unknown()).optional(),
+  queryArgs: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   count: zod.z.number().int().min(0).optional(),
   countBy: zod.z.string().optional(),
   cellSlug: zod.z.union([CellSlugSchema2, zod.z.string()]).optional()
@@ -6627,14 +6788,14 @@ var AuthTokenParamsSchema2 = zod.z.object({
 var AuthParamsSchema2 = zod.z.object({
   cellSlug: zod.z.union([CellSlugSchema2, zod.z.string()]).optional(),
   encrypt: zod.z.boolean().optional(),
-  callback: zod.z.function().optional()
+  callback: zod.z.custom((value) => typeof value === "function").optional()
 }).strict();
 var GuestAuthParamsSchema2 = zod.z.object({
   cellSlug: zod.z.union([CellSlugSchema2, zod.z.string()]).optional()
 }).strict();
 var GraphQLRequestSchema2 = zod.z.object({
   query: zod.z.string().min(1),
-  variables: zod.z.record(zod.z.unknown()).optional(),
+  variables: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
   operationName: zod.z.string().optional()
 }).strict();
 var GraphQLErrorSchema2 = zod.z.object({
@@ -6644,12 +6805,12 @@ var GraphQLErrorSchema2 = zod.z.object({
     column: zod.z.number().int()
   })).optional(),
   path: zod.z.array(zod.z.union([zod.z.string(), zod.z.number()])).optional(),
-  extensions: zod.z.record(zod.z.unknown()).optional()
+  extensions: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 }).strict();
 var GraphQLResponseSchema2 = zod.z.object({
   data: zod.z.unknown().optional(),
   errors: zod.z.array(GraphQLErrorSchema2).optional(),
-  extensions: zod.z.record(zod.z.unknown()).optional()
+  extensions: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 }).strict();
 function safeParse(schema, data) {
   const result = schema.safeParse(data);
@@ -6659,7 +6820,7 @@ function safeParse(schema, data) {
       error: {
         issues: result.error.issues,
         message: result.error.message,
-        formatted: result.error.format()
+        formatted: zod.z.treeifyError(result.error)
       }
     };
   }
@@ -11920,7 +12081,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 = {