@se-oss/assert 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shahrad Elahi
+
+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

@@ -0,0 +1,108 @@
+# @se-oss/assert
+
+[![CI](https://github.com/shahradelahi/assert/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/shahradelahi/assert/actions/workflows/ci.yml)
+[![NPM Version](https://img.shields.io/npm/v/@se-oss/assert.svg)](https://www.npmjs.com/package/@se-oss/assert)
+[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat)](/LICENSE)
+![npm bundle size](https://img.shields.io/bundlephobia/minzip/@se-oss/assert)
+[![Install Size](https://packagephobia.com/badge?p=@se-oss/assert)](https://packagephobia.com/result?p=@se-oss/assert)
+
+_@se-oss/assert_ is a lightweight, type-safe assertion library for TypeScript and JavaScript, powered by [@se-oss/is](https://github.com/shahradelahi/is).
+
+---
+
+- [Installation](#-installation)
+- [Usage](#-usage)
+- [Documentation](#-documentation)
+- [Contributing](#-contributing)
+- [License](#license)
+
+## 📦 Installation
+
+```bash
+npm install @se-oss/assert
+```
+
+<details>
+<summary>Install using your favorite package manager</summary>
+
+**pnpm**
+
+```bash
+pnpm install @se-oss/assert
+```
+
+**yarn**
+
+```bash
+yarn add @se-oss/assert
+```
+
+</details>
+
+## 📖 Usage
+
+_@se-oss/assert_ provides a set of assertion functions that throw a `TypeError` if the condition is not met. It is powered by [@se-oss/is](https://github.com/shahradelahi/is), so all predicates from `is` are available as assertions.
+
+### Basic Example
+
+```typescript
+import { assert } from '@se-oss/assert';
+
+// Throws if not a string
+assert.string('hello');
+
+// Throws with a custom message
+assert.string(123, 'Value must be a string');
+// => TypeError: Value must be a string
+```
+
+### Common Assertions
+
+```typescript
+// Numbers
+assert.number(42);
+assert.integer(42);
+assert.positiveNumber(10);
+assert.inRange(15, 'Not in range', [10, 20]);
+
+// Objects & Arrays
+assert.plainObject({ foo: 'bar' });
+assert.array([1, 2, 3]);
+assert.nonEmptyArray([1]);
+
+// Strings
+assert.nonEmptyString('hello');
+assert.json('{"a":1}');
+assert.ipv4('127.0.0.1');
+
+// Logic
+assert.truthy(true);
+assert.falsy(false);
+```
+
+### Integration with TypeScript
+
+The library is fully type-safe and provides type guards for your variables.
+
+```typescript
+function process(value: unknown) {
+  assert.string(value);
+
+  // 'value' is now narrowed to string
+  console.log(value.toUpperCase());
+}
+```
+
+## 📚 Documentation
+
+For all configuration options, please see [the API docs](https://www.jsdocs.io/package/@se-oss/assert).
+
+## 🤝 Contributing
+
+Want to contribute? Awesome! To show your support is to star the project, or to raise issues on [GitHub](https://github.com/shahradelahi/assert)
+
+Thanks again for your support, it is much appreciated! 🙏
+
+## License
+
+[MIT](/LICENSE) © [Shahrad Elahi](https://github.com/shahradelahi) and [contributors](https://github.com/shahradelahi/assert/graphs/contributors).

package/dist/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  assert: () => assert
+});
+module.exports = __toCommonJS(index_exports);
+var import_is = __toESM(require("@se-oss/is"), 1);
+var assert = new Proxy({}, {
+  get(_target, property) {
+    return (value, message, ...args) => {
+      const predicate = import_is.default[property];
+      if (typeof predicate !== "function") {
+        throw new Error(`Unknown assertion: ${property}`);
+      }
+      if (!predicate(value, ...args)) {
+        const defaultMessage = `Expected value to be ${property}, got ${typeof value}`;
+        throw new TypeError(message || defaultMessage);
+      }
+    };
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assert
+});

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import is from '@se-oss/is';
+
+type IsType = typeof is;
+type Assert = {
+    [K in keyof IsType]: IsType[K] extends (value: any, ...args: infer A) => value is infer T ? (value: unknown, message?: string, ...args: A) => asserts value is T : IsType[K] extends (value: any, ...args: infer A) => boolean ? (value: unknown, message?: string, ...args: A) => void : never;
+};
+declare const assert: Assert;
+
+export { type Assert, assert };

package/dist/index.js

@@ -0,0 +1,19 @@
+// src/index.ts
+import is from "@se-oss/is";
+var assert = new Proxy({}, {
+  get(_target, property) {
+    return (value, message, ...args) => {
+      const predicate = is[property];
+      if (typeof predicate !== "function") {
+        throw new Error(`Unknown assertion: ${property}`);
+      }
+      if (!predicate(value, ...args)) {
+        const defaultMessage = `Expected value to be ${property}, got ${typeof value}`;
+        throw new TypeError(message || defaultMessage);
+      }
+    };
+  }
+});
+export {
+  assert
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@se-oss/assert",
+  "version": "1.0.0",
+  "description": "A lightweight, type-safe assertion library based on @se-oss/is.",
+  "keywords": [
+    "assert",
+    "assertion",
+    "validation",
+    "type-check",
+    "type-safe",
+    "is"
+  ],
+  "homepage": "https://github.com/shahradelahi/assert",
+  "repository": "github:shahradelahi/assert",
+  "license": "MIT",
+  "author": "Shahrad Elahi <shahrad@litehex.com> (https://github.com/shahradelahi)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**",
+    "!**/*.d.cts"
+  ],
+  "scripts": {
+    "bench": "vitest bench --run",
+    "build": "pnpm typecheck && tsup",
+    "clean": "git clean -dfx node_modules dist .tsbuildinfo",
+    "dev": "tsup --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "pnpm typecheck && eslint .",
+    "lint:fix": "eslint --fix .",
+    "prepublishOnly": "pnpm build && pnpm lint && pnpm format:check && pnpm test",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@shahrad/prettier-config",
+  "dependencies": {
+    "@se-oss/is": "^1.0.0"
+  },
+  "devDependencies": {
+    "@shahrad/eslint-config": "^1.0.1",
+    "@shahrad/prettier-config": "^1.2.2",
+    "@shahrad/tsconfig": "^1.2.0",
+    "@types/node": "^25.0.10",
+    "eslint": "^9.39.2",
+    "globals": "^17.1.0",
+    "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "packageManager": "pnpm@10.26.0+sha512.3b3f6c725ebe712506c0ab1ad4133cf86b1f4b687effce62a9b38b4d72e3954242e643190fc51fa1642949c735f403debd44f5cb0edd657abe63a8b6a7e1e402"
+}