@anvil-js/client 0.0.1

package/LICENSE

@@ -0,0 +1,99 @@
+ANVIL — PROPRIETARY LICENSE
+Copyright (c) 2024–2026 Anvil contributors. All rights reserved.
+
+================================================================================
+NOTICE: PROPRIETARY SOFTWARE — UNPUBLISHED, NOT FOR DISTRIBUTION
+================================================================================
+
+This software and associated documentation files (the "Software") are
+proprietary and confidential. The Software is NOT open-source, source-available,
+or public in any form.
+
+All rights, title, and interest in and to the Software, including all
+intellectual property rights therein, are and shall remain the exclusive
+property of the copyright holders.
+
+================================================================================
+1. INTERNAL USE GRANT
+================================================================================
+
+Permission is hereby granted, free of charge, to authorized contributors and
+personnel explicitly added to this repository to use, copy, modify, merge,
+publish, and distribute the Software, subject to the following conditions:
+
+  a) Access must be explicitly granted by a repository administrator.
+  b) All copies, modifications, and derivative works remain the property of
+     the copyright holders.
+  c) Distribution outside the authorized contributor list is strictly
+     prohibited.
+
+================================================================================
+2. NO PUBLIC DISTRIBUTION
+================================================================================
+
+The following activities are STRICTLY PROHIBITED without prior written
+permission from the copyright holders:
+
+  a) Publishing the Software (or any portion thereof) to any public code
+     hosting platform (GitHub public, GitLab public, Bitbucket public, etc.).
+  b) Publishing the Software (or any portion thereof) to any package registry
+     (npmjs public, GitHub Packages public, PyPI, crates.io, etc.).
+  c) Distributing compiled binaries, installers, or any build artifacts
+     outside of authorized channels.
+  d) Publishing documentation, screenshots, or marketing materials that
+     reveal the internal architecture, source code, or business logic of
+     the Software.
+  e) Using the Software (or any portion thereof) to provide a competing
+     commercial product or service.
+  f) Sublicensing, reselling, or renting the Software.
+
+================================================================================
+3. THIRD-PARTY COMPONENTS
+================================================================================
+
+The Software may include or depend on third-party open-source components,
+each governed by its own license. A list of such components and their
+licenses is provided in THIRD-PARTY-NOTICES (or equivalent file) within
+the repository. Use of such components is subject to their respective
+license terms.
+
+================================================================================
+4. TRADEMARKS
+================================================================================
+
+"Anvil", the Anvil logo, and any related marks are trademarks of the
+copyright holders. No license, express or implied, is granted to use
+such trademarks without prior written permission.
+
+================================================================================
+5. NO WARRANTY
+================================================================================
+
+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.
+
+================================================================================
+6. TERMINATION
+================================================================================
+
+Any breach of the conditions in this license automatically terminates
+all rights granted herein. The copyright holders reserve the right to
+revoke access to the repository at any time, for any reason, at their
+sole discretion.
+
+================================================================================
+SUMMARY (NON-BINDING)
+================================================================================
+
+  ✓ You CAN:    contribute to this private repository if you have access
+  ✗ You MUST:   keep all code, architecture, and business logic confidential
+  ✗ You CANNOT: publish, distribute, sublicense, or commercialize the Software
+  ✗ You CANNOT: use the "Anvil" name/logo for any external purpose
+
+If you have questions about this license or wish to request permission
+for activities prohibited herein, contact the repository administrators.

package/README.md

@@ -0,0 +1,31 @@
+# @anvil-js/client
+
+Typed client for the [Anvil](https://anvil.my) API: the tRPC router types,
+Zod schemas, TanStack Query React hooks, and the Essential WebSocket client.
+
+```bash
+npm i @anvil-js/client
+# react hooks need react as a peer:
+npm i react @tanstack/react-query
+```
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@anvil-js/client` | tRPC client factory, router type (`AppRouter`), core types |
+| `@anvil-js/client/react` | TanStack Query provider + typed hooks |
+| `@anvil-js/client/schemas` | Zod schemas (auth, builds, social, cosmetics, …) |
+| `@anvil-js/client/server` | server-side router type helpers |
+| `@anvil-js/client/ws` | Essential binary WS client + codec |
+
+```ts
+import { createAnvilClient } from '@anvil-js/client';
+
+const client = createAnvilClient({
+  baseUrl: 'https://anvil.my/v1',
+  getToken: async () => localStorage.getItem('anvil.jwt') ?? undefined,
+});
+```
+
+ESM-only. Published from the Anvil monorepo (`packages/client`).

package/dist/chunk-DV6XOONA.js

@@ -0,0 +1,41 @@
+import { createTRPCReact } from '@trpc/react-query';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { useState } from 'react';
+import { httpLink } from '@trpc/client';
+import { jsx } from 'react/jsx-runtime';
+
+// src/react/provider.tsx
+var trpc = createTRPCReact();
+function AnvilClientProvider({ config, children, devFetch }) {
+  const [queryClient] = useState(
+    () => new QueryClient({
+      defaultOptions: {
+        queries: {
+          staleTime: 5 * 60 * 1e3,
+          retry: 1,
+          refetchOnWindowFocus: false
+        }
+      }
+    })
+  );
+  const [trpcClient] = useState(
+    () => trpc.createClient({
+      links: [
+        httpLink({
+          url: config.baseUrl,
+          headers: async () => {
+            const token = await config.getToken();
+            return token ? { authorization: `Bearer ${token}` } : {};
+          },
+          fetch: devFetch
+        })
+      ]
+    })
+  );
+  return /* @__PURE__ */ jsx(trpc.Provider, { client: trpcClient, queryClient, children: /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children }) });
+}
+var useAnvilClient = trpc.useContext;
+
+export { AnvilClientProvider, trpc, useAnvilClient };
+//# sourceMappingURL=chunk-DV6XOONA.js.map
+//# sourceMappingURL=chunk-DV6XOONA.js.map

package/dist/chunk-DV6XOONA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx"],"names":[],"mappings":";;;;;;;AASO,IAAM,OAAO,eAAA;AAyEb,SAAS,mBAAA,CAAoB,EAAE,MAAA,EAAQ,QAAA,EAAU,UAAS,EAA6B;AAC5F,EAAA,MAAM,CAAC,WAAW,CAAA,GAAI,QAAA;AAAA,IACpB,MACE,IAAI,WAAA,CAAY;AAAA,MACd,cAAA,EAAgB;AAAA,QACd,OAAA,EAAS;AAAA,UACP,SAAA,EAAW,IAAI,EAAA,GAAK,GAAA;AAAA,UACpB,KAAA,EAAO,CAAA;AAAA,UACP,oBAAA,EAAsB;AAAA;AACxB;AACF,KACD;AAAA,GACL;AAEA,EAAA,MAAM,CAAC,UAAU,CAAA,GAAI,QAAA;AAAA,IAAS,MAC5B,KAAK,YAAA,CAAa;AAAA,MAChB,KAAA,EAAO;AAAA,QACL,QAAA,CAAS;AAAA,UACP,KAAK,MAAA,CAAO,OAAA;AAAA,UACZ,SAAS,YAAY;AACnB,YAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,QAAA,EAAS;AACpC,YAAA,OAAO,QAAQ,EAAE,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA,KAAO,EAAC;AAAA,UACzD,CAAA;AAAA,UACA,KAAA,EAAO;AAAA,SACR;AAAA;AACH,KACD;AAAA,GACH;AAEA,EAAA,uBACE,GAAA,CAAC,IAAA,CAAK,QAAA,EAAL,EAAc,MAAA,EAAQ,UAAA,EAAY,WAAA,EACjC,QAAA,kBAAA,GAAA,CAAC,mBAAA,EAAA,EAAoB,MAAA,EAAQ,WAAA,EAAc,QAAA,EAAS,CAAA,EACtD,CAAA;AAEJ;AAEO,IAAM,iBAAiB,IAAA,CAAK","file":"chunk-DV6XOONA.js","sourcesContent":["'use client';\n\nimport { createTRPCReact } from '@trpc/react-query';\nimport { QueryClient, QueryClientProvider } from '@tanstack/react-query';\nimport { useState, type ReactNode } from 'react';\nimport { httpLink } from '@trpc/client';\nimport type { AppRouter } from '../router';\nimport type { AnvilClientConfig } from '../client/factory';\n\nexport const trpc = createTRPCReact<AppRouter>();\n\nexport interface AnvilClientProviderProps {\n  config: AnvilClientConfig;\n  children: ReactNode;\n}\n\n/**\n * The Anvil tRPC client.\n *\n * History note: earlier versions of this provider used\n * `splitLink({ true: wsLink(...), false: httpBatchLink(...) })` so\n * subscription procedures would multiplex over a single WebSocket.\n * That setup opened a WebSocket on every mount, retried\n * indefinitely against `ws://localhost:3001/v1` (no real WS in dev),\n * spammed the console with \"ws connection error\", and held onto\n * EventSource handles that the GC couldn't free  --  a noticeable\n * memory leak on the launcher tab.\n *\n * The router now has zero `subscription` procedures\n * (chat.subscribeChannel / social.presence.get are queries with\n * client-side polling, per Phase 5b / 6c). When real subscriptions\n * land, they should use a *dedicated* WS gateway with explicit\n * connect-on-subscribe semantics (tRPC v11 `createWSClient({ lazy: true })`)\n * so a tab with no active subscription never opens a socket.\n *\n * This scaffold uses `httpLink` (one request per call) instead of\n * `httpBatchLink`. Reason: the MSW dev layer returns a single\n * response object per registered handler. tRPC v11's batched GET\n * format (`?batch=1&input=...`) expects an array response\n * (`[{ result: { data } }, ...]`) and the dev path doesn't emit\n * that shape. Single-call links avoid the entire mismatch and keep\n * the dev path simple. When `apps/api` is wired, swapping back\n * to `httpBatchLink({ maxItems: 10 })` is a one-line change.\n */\nexport interface AnvilClientProviderProps {\n  config: AnvilClientConfig;\n  children: ReactNode;\n  /**\n   * Optional custom fetch for the in-process dev mock. When\n   * provided, the tRPC client uses this fetch instead of the\n   * real network. Production callers leave this undefined; the\n   * `apps/web` dev bridge passes its own implementation.\n   */\n  devFetch?: typeof fetch;\n}\n\n/**\n * The Anvil tRPC client.\n *\n * History note: earlier versions of this provider used\n * `splitLink({ true: wsLink(...), false: httpBatchLink(...) })` so\n * subscription procedures would multiplex over a single WebSocket.\n * That setup opened a WebSocket on every mount, retried\n * indefinitely against `ws://localhost:3001/v1` (no real WS in dev),\n * spammed the console with \"ws connection error\", and held onto\n * EventSource handles that the GC couldn't free  --  a noticeable\n * memory leak on the launcher tab.\n *\n * The router now has zero `subscription` procedures\n * (chat.subscribeChannel / social.presence.get are queries with\n * client-side polling, per Phase 5b / 6c). When real subscriptions\n * land, they should use a *dedicated* WS gateway with explicit\n * connect-on-subscribe semantics (tRPC v11 `createWSClient({ lazy: true })`)\n * so a tab with no active subscription never opens a socket.\n *\n * This scaffold uses `httpLink` with the default JSON transformer\n * (no superjson). For the dev renderer, a `devFetch` override\n * routes every request through the in-process mock registry in\n * `apps/web/src/lib/anvil-api/dev-fetch.ts`, bypassing the MSW\n * service worker entirely (which had wire-format issues with\n * tRPC v11's GET-batched queries).\n */\nexport function AnvilClientProvider({ config, children, devFetch }: AnvilClientProviderProps) {\n  const [queryClient] = useState(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            staleTime: 5 * 60 * 1000,\n            retry: 1,\n            refetchOnWindowFocus: false,\n          },\n        },\n      }),\n  );\n\n  const [trpcClient] = useState(() =>\n    trpc.createClient({\n      links: [\n        httpLink({\n          url: config.baseUrl,\n          headers: async () => {\n            const token = await config.getToken();\n            return token ? { authorization: `Bearer ${token}` } : {};\n          },\n          fetch: devFetch,\n        }),\n      ],\n    }),\n  );\n\n  return (\n    <trpc.Provider client={trpcClient} queryClient={queryClient}>\n      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>\n    </trpc.Provider>\n  );\n}\n\nexport const useAnvilClient = trpc.useContext;\n"]}