netscry 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NetScry contributors
+
+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/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# `netscry`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The top-level NetScry npm package. It brings together `@netscry/core`, `@netscry/schemas`, and `@netscry/sdk` behind one unscoped import. The scoped packages remain independently installable.
+
+## Usage
+
+```ts
+import { Effect } from "effect";
+import { sdk } from "netscry";
+
+const client = sdk.createNetScryClient({
+  baseUrl: "https://netscry.mynameistito.com",
+});
+
+const health = await Effect.runPromise(client.health());
+```
+
+The other package APIs are available under `core` and `schemas`:
+
+```ts
+import { core, schemas } from "netscry";
+
+const address = core.parseIpAddress("1.1.1.1");
+const healthSchema = schemas.ApiHealthResponseSchema;
+```
+
+The client uses standard Fetch APIs, validates responses against the shared contracts, and returns Effects with typed SDK failures. `me()` reports the IP address of the request reaching NetScry; when called from a server, this is generally the server's egress IP, not its original visitor's IP.
+
+## Runtime and package contents
+
+The package supports Node.js 20 or newer and other runtimes with standard Fetch APIs. Its npm tarball contains the ESM entry point, TypeScript declarations, README, and MIT license only.
+
+## Development
+
+From the repository root, run `bun run build:packages` to build all workspace libraries. `bun run verify:packages` also exercises this package from Node without Bun workspace source aliases.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { NetScrySdkError, createNetScryClient } from "@netscry/sdk";
+export type { NetScryClient, NetScryClientOptions, NetScryFetch, } from "@netscry/sdk";

package/dist/index.js

@@ -0,0 +1 @@
+export { NetScrySdkError, createNetScryClient } from "@netscry/sdk";

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "netscry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "homepage": "https://github.com/mynameistito/netscry#readme",
+  "bugs": {
+    "url": "https://github.com/mynameistito/netscry/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mynameistito/netscry.git",
+    "directory": "packages/netscry"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test:consumer": "node test/consumer.mjs"
+  },
+  "dependencies": {
+    "@netscry/core": "^0.1.1",
+    "@netscry/schemas": "^0.1.1",
+    "@netscry/sdk": "^0.1.1"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}