schemos 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wonhee Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { Coin, StdFee } from './types.js';
+export interface CosmWasmQueryClient {
+    queryContractSmart(address: string, query: Record<string, unknown>): Promise<unknown>;
+}
+export interface CosmWasmExecuteClient<TExecuteResult = unknown> extends CosmWasmQueryClient {
+    execute(sender: string, address: string, msg: Record<string, unknown>, fee: StdFee | 'auto', memo?: string, funds?: readonly Coin[]): Promise<TExecuteResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,cAAc,GAAG,OAAO,CAC7D,SAAQ,mBAAmB;IAC3B,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GACtB,OAAO,CAAC,cAAc,CAAC,CAAA;CAC3B"}

package/dist/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":""}

package/dist/client.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test-d.d.ts.map

package/dist/client.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test-d.d.ts","sourceRoot":"","sources":["../src/client.test-d.ts"],"names":[],"mappings":""}

package/dist/client.test-d.js

@@ -0,0 +1,41 @@
+import { assertType, expectTypeOf, test } from 'vitest';
+test('CosmWasmExecuteClient extends CosmWasmQueryClient', () => {
+    expectTypeOf().toExtend();
+});
+test('CosmWasmQueryClient.queryContractSmart signature', () => {
+    expectTypeOf().toBeFunction();
+    expectTypeOf().parameters.toEqualTypeOf();
+    expectTypeOf().returns.toEqualTypeOf();
+});
+test('CosmWasmExecuteClient.execute signature', () => {
+    expectTypeOf().toBeFunction();
+    // Verify it accepts the correct argument types
+    const mockClient = {
+        queryContractSmart: async () => ({}),
+        execute: async () => ({}),
+    };
+    const fee = {
+        amount: [{ denom: 'uosmo', amount: '500' }],
+        gas: '200000',
+    };
+    const funds = [{ denom: 'uosmo', amount: '1000' }];
+    // Valid calls
+    assertType(mockClient.execute('sender', 'contract', { transfer: {} }, fee));
+    assertType(mockClient.execute('sender', 'contract', { transfer: {} }, 'auto'));
+    assertType(mockClient.execute('sender', 'contract', { transfer: {} }, fee, 'memo', funds));
+});
+test('CosmWasmExecuteClient generic propagates execute result type', () => {
+    expectTypeOf().returns.toEqualTypeOf();
+    // queryContractSmart always returns unknown regardless of client
+    expectTypeOf().returns.toEqualTypeOf();
+});
+test('CosmWasmQueryClient is assignable from execute client', () => {
+    // An execute client should be usable anywhere a query client is expected
+    const execClient = {
+        queryContractSmart: async () => ({}),
+        execute: async () => ({}),
+    };
+    const queryClient = execClient;
+    assertType(queryClient);
+});
+//# sourceMappingURL=client.test-d.js.map

package/dist/client.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test-d.js","sourceRoot":"","sources":["../src/client.test-d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAIvD,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,YAAY,EAAyB,CAAC,QAAQ,EAAuB,CAAA;AACvE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,YAAY,EAA6C,CAAC,YAAY,EAAE,CAAA;IACxE,YAAY,EAET,CAAC,UAAU,CAAC,aAAa,EAEzB,CAAA;IACH,YAAY,EAET,CAAC,OAAO,CAAC,aAAa,EAAoB,CAAA;AAC/C,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,YAAY,EAAoC,CAAC,YAAY,EAAE,CAAA;IAE/D,+CAA+C;IAC/C,MAAM,UAAU,GAA0B;QACxC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAA;IAED,MAAM,GAAG,GAAW;QAClB,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3C,GAAG,EAAE,QAAQ;KACd,CAAA;IACD,MAAM,KAAK,GAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAEnE,cAAc;IACd,UAAU,CACR,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAChE,CAAA;IACD,UAAU,CACR,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CACnE,CAAA;IACD,UAAU,CACR,UAAU,CAAC,OAAO,CAChB,QAAQ,EACR,UAAU,EACV,EAAE,QAAQ,EAAE,EAAE,EAAE,EAChB,GAAG,EACH,MAAM,EACN,KAAK,CACN,CACF,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;IAIxE,YAAY,EAAqB,CAAC,OAAO,CAAC,aAAa,EAEpD,CAAA;IACH,iEAAiE;IACjE,YAAY,EAAgC,CAAC,OAAO,CAAC,aAAa,EAE/D,CAAA;AACL,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;IACjE,yEAAyE;IACzE,MAAM,UAAU,GAA0B;QACxC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAA;IACD,MAAM,WAAW,GAAwB,UAAU,CAAA;IACnD,UAAU,CAAsB,WAAW,CAAC,CAAA;AAC9C,CAAC,CAAC,CAAA"}

package/dist/contract.bench-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.bench-d.d.ts.map

package/dist/contract.bench-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.bench-d.d.ts","sourceRoot":"","sources":["../src/contract.bench-d.ts"],"names":[],"mappings":""}

package/dist/contract.bench-d.js

@@ -0,0 +1,67 @@
+import { attest } from '@ark/attest';
+import { describe, test } from 'vitest';
+// ---------------------------------------------------------------------------
+// FromSchema instantiation benchmarks
+// ---------------------------------------------------------------------------
+describe('FromSchema on CosmWasm schemas', () => {
+    test('cw20 execute schema (12 messages)', () => {
+        attest.instantiations([16458, 'instantiations']);
+        attest({});
+    });
+    test('cw20 query schema (9 messages)', () => {
+        attest.instantiations([811, 'instantiations']);
+        attest({});
+    });
+});
+// ---------------------------------------------------------------------------
+// Message type extraction benchmarks
+// ---------------------------------------------------------------------------
+describe('Message type extraction', () => {
+    test('extract message names from execute union', () => {
+        attest.instantiations([74, 'instantiations']);
+        attest({});
+    });
+    test('extract transfer args', () => {
+        attest.instantiations([74, 'instantiations']);
+        attest({});
+    });
+});
+// ---------------------------------------------------------------------------
+// Response schema resolution benchmarks
+// ---------------------------------------------------------------------------
+describe('Response schema resolution (lazy FromSchema)', () => {
+    test('resolve balance response', () => {
+        attest.instantiations([1115, 'instantiations']);
+        attest({});
+    });
+    test('resolve token_info response', () => {
+        attest.instantiations([1488, 'instantiations']);
+        attest({});
+    });
+    test('resolve allowance response', () => {
+        attest.instantiations([28809, 'instantiations']);
+        attest({});
+    });
+});
+// ---------------------------------------------------------------------------
+// Full contract type construction benchmarks
+// ---------------------------------------------------------------------------
+describe('TypedContract construction', () => {
+    test('TypedQueryContract without responses', () => {
+        attest.instantiations([69, 'instantiations']);
+        attest({});
+    });
+    test('TypedQueryContract with responses', () => {
+        attest.instantiations([139, 'instantiations']);
+        attest({});
+    });
+    test('TypedContract without responses', () => {
+        attest.instantiations([60, 'instantiations']);
+        attest({});
+    });
+    test('TypedContract with responses', () => {
+        attest.instantiations([142, 'instantiations']);
+        attest({});
+    });
+});
+//# sourceMappingURL=contract.bench-d.js.map

package/dist/contract.bench-d.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,27 @@
+import type { FromSchema, JSONSchema } from 'json-schema-to-ts';
+import type { CosmWasmExecuteClient, CosmWasmQueryClient } from './client.js';
+import type { Coin, StdFee } from './types.js';
+/** Extract all top-level keys from a union of single-key objects. */
+type MessageNames<T> = T extends Record<string, unknown> ? keyof T & string : never;
+/** Extract the value type for a specific key from a union. */
+type MessageArgs<T, K extends string> = T extends Record<K, infer V> ? V : never;
+export interface TypedQueryContract<TQueryMsg, TResponses extends Record<string, JSONSchema> | undefined = undefined> {
+    query<K extends MessageNames<TQueryMsg>>(msg: K, args: MessageArgs<TQueryMsg, K>): Promise<TResponses extends Record<string, JSONSchema> ? K extends keyof TResponses ? FromSchema<TResponses[K]> : unknown : unknown>;
+}
+export interface TypedContract<TExecuteMsg, TQueryMsg, TExecuteResult = unknown, TResponses extends Record<string, JSONSchema> | undefined = undefined> extends TypedQueryContract<TQueryMsg, TResponses> {
+    execute<K extends MessageNames<TExecuteMsg>>(sender: string, msg: K, args: MessageArgs<TExecuteMsg, K>, fee: StdFee | 'auto', memo?: string, funds?: readonly Coin[]): Promise<TExecuteResult>;
+}
+/** Full contract with execute + query. */
+export declare function createTypedContract<const TExecuteSchema extends JSONSchema, const TQuerySchema extends JSONSchema, const TResponses extends Record<string, JSONSchema> | undefined = undefined, TExecuteResult = unknown>(client: CosmWasmExecuteClient<TExecuteResult>, contractAddress: string, schemas: {
+    execute: TExecuteSchema;
+    query: TQuerySchema;
+    responses?: TResponses;
+}): TypedContract<FromSchema<TExecuteSchema>, FromSchema<TQuerySchema>, TExecuteResult, TResponses>;
+/** Query-only contract (no execute capability). */
+export declare function createTypedContract<const TQuerySchema extends JSONSchema, const TResponses extends Record<string, JSONSchema> | undefined = undefined>(client: CosmWasmQueryClient, contractAddress: string, schemas: {
+    execute?: never;
+    query: TQuerySchema;
+    responses?: TResponses;
+}): TypedQueryContract<FromSchema<TQuerySchema>, TResponses>;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAM9C,qEAAqE;AACrE,KAAK,YAAY,CAAC,CAAC,IACjB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAE9D,8DAA8D;AAC9D,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAMhF,MAAM,WAAW,kBAAkB,CACjC,SAAS,EACT,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS;IAErE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,SAAS,CAAC,EACrC,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,GAC9B,OAAO,CACR,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACzC,CAAC,SAAS,MAAM,UAAU,GACxB,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACzB,OAAO,GACT,OAAO,CACZ,CAAA;CACF;AAED,MAAM,WAAW,aAAa,CAC5B,WAAW,EACX,SAAS,EACT,cAAc,GAAG,OAAO,EACxB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS,CACrE,SAAQ,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC;IACjD,OAAO,CAAC,CAAC,SAAS,YAAY,CAAC,WAAW,CAAC,EACzC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GACtB,OAAO,CAAC,cAAc,CAAC,CAAA;CAC3B;AAMD,0CAA0C;AAC1C,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,cAAc,SAAS,UAAU,EACvC,KAAK,CAAC,YAAY,SAAS,UAAU,EACrC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS,EAC3E,cAAc,GAAG,OAAO,EAExB,MAAM,EAAE,qBAAqB,CAAC,cAAc,CAAC,EAC7C,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE;IACP,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB,GACA,aAAa,CACd,UAAU,CAAC,cAAc,CAAC,EAC1B,UAAU,CAAC,YAAY,CAAC,EACxB,cAAc,EACd,UAAU,CACX,CAAA;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,YAAY,SAAS,UAAU,EACrC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS,EAE3E,MAAM,EAAE,mBAAmB,EAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,UAAU,CAAA;CACvB,GACA,kBAAkB,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAA"}

package/dist/contract.js

@@ -0,0 +1,30 @@
+import { Ajv } from 'ajv';
+/** Implementation. */
+export function createTypedContract(client, contractAddress, schemas) {
+    const ajv = new Ajv({ validateFormats: false });
+    const validateQuery = ajv.compile(schemas.query);
+    const validateExecute = schemas.execute
+        ? ajv.compile(schemas.execute)
+        : undefined;
+    const contract = {
+        async query(msg, args) {
+            const envelope = { [msg]: args };
+            if (!validateQuery(envelope)) {
+                throw new Error(`Query validation failed for "${msg}": ${ajv.errorsText(validateQuery.errors)}`);
+            }
+            return client.queryContractSmart(contractAddress, envelope);
+        },
+    };
+    if (schemas.execute && validateExecute) {
+        const execClient = client;
+        contract.execute = async (sender, msg, args, fee, memo, funds) => {
+            const envelope = { [msg]: args };
+            if (!validateExecute(envelope)) {
+                throw new Error(`Execute validation failed for "${msg}": ${ajv.errorsText(validateExecute.errors)}`);
+            }
+            return execClient.execute(sender, contractAddress, envelope, fee, memo, funds);
+        };
+    }
+    return contract;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AA2FzB,sBAAsB;AACtB,MAAM,UAAU,mBAAmB,CACjC,MAA2B,EAC3B,eAAuB,EACvB,OAIC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAA;IAE/C,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAA;IAC3E,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO;QACrC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAkC,CAAC;QACzD,CAAC,CAAC,SAAS,CAAA;IAEb,MAAM,QAAQ,GAA4B;QACxC,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAa;YACpC,MAAM,QAAQ,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;YAChC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,gCAAgC,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAChF,CAAA;YACH,CAAC;YACD,OAAO,MAAM,CAAC,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;QAC7D,CAAC;KACF,CAAA;IAED,IAAI,OAAO,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,MAA+B,CAAA;QAClD,QAAQ,CAAC,OAAO,GAAG,KAAK,EACtB,MAAc,EACd,GAAW,EACX,IAAa,EACb,GAAoB,EACpB,IAAa,EACb,KAAuB,EACvB,EAAE;YACF,MAAM,QAAQ,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;YAChC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,kCAAkC,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CACpF,CAAA;YACH,CAAC;YACD,OAAO,UAAU,CAAC,OAAO,CACvB,MAAM,EACN,eAAe,EACf,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,KAAK,CACN,CAAA;QACH,CAAC,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/contract.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.test-d.d.ts.map

package/dist/contract.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.test-d.d.ts","sourceRoot":"","sources":["../src/contract.test-d.ts"],"names":[],"mappings":""}

package/dist/contract.test-d.js

@@ -0,0 +1,147 @@
+import { assertType, expectTypeOf, test } from 'vitest';
+import { createTypedContract } from './contract.js';
+// ---------------------------------------------------------------------------
+// Test: FromSchema produces correct message union
+// ---------------------------------------------------------------------------
+test('ExecuteMsg is a union of single-key objects', () => {
+    assertType({
+        transfer: { amount: '1000', recipient: 'osmo1abc' },
+    });
+    assertType({ burn: { amount: '500' } });
+    assertType({
+        send: { amount: '100', contract: 'osmo1xyz', msg: 'base64' },
+    });
+    assertType({
+        mint: { amount: '2000', recipient: 'osmo1def' },
+    });
+});
+test('ExecuteMsg rejects invalid message name', () => {
+    // @ts-expect-error - 'xfer' is not a valid execute message name
+    assertType({ xfer: {} });
+});
+test('ExecuteMsg rejects typo in field name', () => {
+    assertType({
+        // @ts-expect-error - 'recipent' is a typo
+        transfer: { amount: '1000', recipent: 'osmo1abc' },
+    });
+});
+test('ExecuteMsg rejects missing required field', () => {
+    // @ts-expect-error - missing 'recipient'
+    assertType({ transfer: { amount: '1000' } });
+});
+test('QueryMsg is a union of single-key objects', () => {
+    assertType({ balance: { address: 'osmo1abc' } });
+    assertType({ token_info: {} });
+    assertType({
+        allowance: { owner: 'osmo1abc', spender: 'osmo1def' },
+    });
+});
+test('QueryMsg rejects invalid query name', () => {
+    // @ts-expect-error - 'balances' is not a valid query name
+    assertType({ balances: { address: 'osmo1abc' } });
+});
+test('QueryMsg rejects missing required field', () => {
+    // @ts-expect-error - missing 'address'
+    assertType({ balance: {} });
+});
+test('full contract has execute and query methods', () => {
+    expectTypeOf().toHaveProperty('execute');
+    expectTypeOf().toHaveProperty('query');
+});
+test('query-only contract has query but not execute', () => {
+    expectTypeOf().toHaveProperty('query');
+    expectTypeOf().not.toHaveProperty('execute');
+});
+test('execute return type is Promise<unknown>', () => {
+    expectTypeOf().toEqualTypeOf();
+});
+test('query return type is Promise<unknown>', () => {
+    expectTypeOf().toEqualTypeOf();
+});
+// ---------------------------------------------------------------------------
+// Test: createTypedContract overload resolution
+// ---------------------------------------------------------------------------
+test('createTypedContract with execute+query returns TypedContract', () => {
+    const client = {
+        queryContractSmart: async () => ({}),
+        execute: async () => ({}),
+    };
+    const contract = createTypedContract(client, 'addr', {
+        execute: {},
+        query: {},
+    });
+    expectTypeOf(contract).toHaveProperty('execute');
+    expectTypeOf(contract).toHaveProperty('query');
+});
+test('createTypedContract with query-only returns TypedQueryContract', () => {
+    const queryClient = {
+        queryContractSmart: async () => ({}),
+    };
+    const contract = createTypedContract(queryClient, 'addr', {
+        query: {},
+    });
+    expectTypeOf(contract).toHaveProperty('query');
+    expectTypeOf(contract).not.toHaveProperty('execute');
+});
+// ---------------------------------------------------------------------------
+// Test: createTypedContract infers result types from client generics
+// ---------------------------------------------------------------------------
+test('execute result type is inferred from client', () => {
+    const client = {
+        queryContractSmart: async () => ({}),
+        execute: async () => ({ transactionHash: 'abc' }),
+    };
+    const contract = createTypedContract(client, 'addr', {
+        execute: {},
+        query: {},
+    });
+    // Call with a specific message name to resolve the generic K
+    const result = contract.execute('sender', 'transfer', { amount: '100', recipient: 'osmo1abc' }, 'auto');
+    expectTypeOf(result).toEqualTypeOf();
+    const queryResult = contract.query('balance', { address: 'osmo1abc' });
+    expectTypeOf(queryResult).toEqualTypeOf();
+});
+// ---------------------------------------------------------------------------
+// Test: query response typing with responses schema
+// ---------------------------------------------------------------------------
+test('query returns typed response when responses provided', () => {
+    const responseSchemas = {
+        balance: {
+            type: 'object',
+            required: ['balance'],
+            properties: { balance: { type: 'string' } },
+            additionalProperties: false,
+        },
+        token_info: {
+            type: 'object',
+            required: ['name', 'symbol'],
+            properties: {
+                name: { type: 'string' },
+                symbol: { type: 'string' },
+            },
+            additionalProperties: false,
+        },
+    };
+    const queryClient = {
+        queryContractSmart: async () => ({}),
+    };
+    const contract = createTypedContract(queryClient, 'addr', {
+        query: {},
+        responses: responseSchemas,
+    });
+    const balanceResult = contract.query('balance', { address: 'osmo1abc' });
+    expectTypeOf(balanceResult).toEqualTypeOf();
+    const tokenInfoResult = contract.query('token_info', {});
+    expectTypeOf(tokenInfoResult).toEqualTypeOf();
+});
+test('query returns unknown when no responses provided', () => {
+    const queryClient = {
+        queryContractSmart: async () => ({}),
+    };
+    const contract = createTypedContract(queryClient, 'addr', {
+        query: {},
+    });
+    const result = contract.query('balance', { address: 'osmo1abc' });
+    expectTypeOf(result).toEqualTypeOf();
+});
+//# sourceMappingURL=contract.test-d.js.map

package/dist/contract.test-d.js.map

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

package/dist/contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.test.d.ts.map

package/dist/contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.test.d.ts","sourceRoot":"","sources":["../src/contract.test.ts"],"names":[],"mappings":""}

package/dist/contract.test.js

@@ -0,0 +1,77 @@
+import { describe, expect, test, vi } from 'vitest';
+import { createTypedContract } from './contract.js';
+import { cw20ExecuteSchema, cw20QuerySchema } from './schemas/cw20/index.js';
+function createMockExecuteClient() {
+    return {
+        queryContractSmart: vi.fn().mockResolvedValue({ balance: '1000' }),
+        execute: vi.fn().mockResolvedValue({ transactionHash: 'abc123' }),
+    };
+}
+function createMockQueryClient() {
+    return {
+        queryContractSmart: vi.fn().mockResolvedValue({ balance: '1000' }),
+    };
+}
+describe('createTypedContract (execute + query)', () => {
+    const mockClient = createMockExecuteClient();
+    const cw20 = createTypedContract(mockClient, 'osmo1contract', {
+        execute: cw20ExecuteSchema,
+        query: cw20QuerySchema,
+    });
+    test('execute passes valid args to client with correct envelope', async () => {
+        await cw20.execute('osmo1sender', 'transfer', { amount: '1000', recipient: 'osmo1recipient' }, 'auto');
+        expect(mockClient.execute).toHaveBeenCalledWith('osmo1sender', 'osmo1contract', { transfer: { amount: '1000', recipient: 'osmo1recipient' } }, 'auto', undefined, undefined);
+    });
+    test('execute passes memo and funds to client', async () => {
+        const fee = { amount: [{ denom: 'uosmo', amount: '500' }], gas: '200000' };
+        const funds = [{ denom: 'uosmo', amount: '100' }];
+        await cw20.execute('osmo1sender', 'burn', { amount: '500' }, fee, 'test memo', funds);
+        expect(mockClient.execute).toHaveBeenCalledWith('osmo1sender', 'osmo1contract', { burn: { amount: '500' } }, fee, 'test memo', funds);
+    });
+    test('execute throws on missing required field', async () => {
+        await expect(
+        // @ts-expect-error - testing runtime validation with invalid args
+        cw20.execute('osmo1sender', 'transfer', { amount: '1000' }, 'auto')).rejects.toThrow('Execute validation failed for "transfer"');
+    });
+    test('execute throws on wrong type for $ref Uint128 (number instead of string)', async () => {
+        await expect(cw20.execute('osmo1sender', 'transfer', 
+        // @ts-expect-error - testing runtime: amount should be string
+        { amount: 1000, recipient: 'osmo1abc' }, 'auto')).rejects.toThrow('Execute validation failed for "transfer"');
+    });
+    test('execute validates $ref correctly (Uint128 as string passes)', async () => {
+        await cw20.execute('osmo1sender', 'mint', { amount: '999', recipient: 'osmo1abc' }, 'auto');
+        expect(mockClient.execute).toHaveBeenCalledWith('osmo1sender', 'osmo1contract', { mint: { amount: '999', recipient: 'osmo1abc' } }, 'auto', undefined, undefined);
+    });
+    test('execute rejects additional properties', async () => {
+        await expect(cw20.execute('osmo1sender', 'burn', 
+        // @ts-expect-error - testing runtime: extra field
+        { amount: '500', extraField: true }, 'auto')).rejects.toThrow('Execute validation failed for "burn"');
+    });
+    test('query passes valid args to client with correct envelope', async () => {
+        await cw20.query('balance', { address: 'osmo1abc' });
+        expect(mockClient.queryContractSmart).toHaveBeenCalledWith('osmo1contract', { balance: { address: 'osmo1abc' } });
+    });
+    test('query throws on missing required field', async () => {
+        await expect(
+        // @ts-expect-error - testing runtime validation
+        cw20.query('balance', {})).rejects.toThrow('Query validation failed for "balance"');
+    });
+    test('query with empty args works for token_info', async () => {
+        await cw20.query('token_info', {});
+        expect(mockClient.queryContractSmart).toHaveBeenCalledWith('osmo1contract', { token_info: {} });
+    });
+});
+describe('createTypedContract (query-only)', () => {
+    const mockClient = createMockQueryClient();
+    const cw20 = createTypedContract(mockClient, 'osmo1contract', {
+        query: cw20QuerySchema,
+    });
+    test('query works on query-only contract', async () => {
+        await cw20.query('balance', { address: 'osmo1abc' });
+        expect(mockClient.queryContractSmart).toHaveBeenCalledWith('osmo1contract', { balance: { address: 'osmo1abc' } });
+    });
+    test('query-only contract does not have execute method', () => {
+        expect('execute' in cw20).toBe(false);
+    });
+});
+//# sourceMappingURL=contract.test.js.map

package/dist/contract.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { CosmWasmExecuteClient, CosmWasmQueryClient } from './client.js';
+export type { TypedContract, TypedQueryContract } from './contract.js';
+export { createTypedContract } from './contract.js';
+export type { Coin, StdFee } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createTypedContract } from './contract.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA"}