@dotsec/core 5.0.0-beta.04208ad

package/README.md

@@ -0,0 +1,60 @@
+# @dotsec/core
+
+Native Node.js bindings for [dotsec](https://github.com/jpwesselink/dotsec-rs) — parse, validate, and format `.env` files with directive support.
+
+## Install
+
+```bash
+npm install @dotsec/core
+```
+
+## Usage
+
+```js
+import { parse, validate, toJson, format } from '@dotsec/core';
+
+// Parse .env content into structured entries
+const entries = parse(`
+# @encrypt
+DB_URL="postgres://localhost"
+DEBUG=true
+`);
+// [
+//   { key: "DB_URL", value: "postgres://localhost", quoteType: "Double", directives: [{ name: "encrypt" }] },
+//   { key: "DEBUG", value: "true", quoteType: "None", directives: [] }
+// ]
+
+// Validate directives and values
+const errors = validate('# @bogus\nFOO="bar"\n');
+// [{ key: "FOO", message: "unknown directive @bogus..." }]
+
+// Convert to JSON
+const json = toJson('FOO=bar\nPORT=3000\n');
+// '[{"FOO":"bar"},{"PORT":"3000"}]'
+
+// Roundtrip format
+const formatted = format('FOO=bar\n');
+// 'FOO=bar\n'
+```
+
+## Supported directives
+
+- `@encrypt` / `@plaintext` — mark variables for encryption
+- `@default-encrypt` / `@default-plaintext` — file-level defaults
+- `@type=string|number|boolean|enum("a","b")` — value type validation
+- `@push=aws-ssm|aws-secrets-manager` — push targets with options
+- `@provider`, `@key-id`, `@region` — file-level encryption config
+
+See the [full documentation](https://jpwesselink.github.io/dotsec-rs/beta/guide/directives.html) for details.
+
+## Platforms
+
+Pre-built binaries are available for:
+
+- macOS (ARM64, x64)
+- Linux (ARM64, x64, glibc)
+- Windows (ARM64, x64)
+
+## License
+
+MIT — [github.com/jpwesselink/dotsec-rs](https://github.com/jpwesselink/dotsec-rs)

package/index.d.ts

@@ -0,0 +1,28 @@
+export interface DirectiveItem {
+  name: string;
+  value: string | null;
+}
+
+export interface ParsedEntry {
+  key: string;
+  value: string;
+  quoteType: string;
+  directives: DirectiveItem[];
+}
+
+export interface ParsedValidationError {
+  key: string;
+  message: string;
+}
+
+/** Parse a .env file string and return entries with their directives. */
+export declare function parse(source: string): ParsedEntry[];
+
+/** Validate entries from a .env file string. Returns a list of validation errors. */
+export declare function validate(source: string): ParsedValidationError[];
+
+/** Convert a .env file string to JSON. */
+export declare function toJson(source: string): string;
+
+/** Roundtrip: parse a .env file string and serialize it back. */
+export declare function format(source: string): string;

package/index.js

@@ -0,0 +1,48 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const PLATFORMS = {
+  "darwin-arm64": "@dotsec/core-darwin-arm64",
+  "darwin-x64": "@dotsec/core-darwin-x64",
+  "linux-x64": "@dotsec/core-linux-x64-gnu",
+  "linux-arm64": "@dotsec/core-linux-arm64-gnu",
+  "win32-x64": "@dotsec/core-win32-x64-msvc",
+  "win32-arm64": "@dotsec/core-win32-arm64-msvc",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
+
+if (!pkg) {
+  throw new Error(
+    `@dotsec/core: unsupported platform ${process.platform}-${process.arch}\n` +
+    `Supported: ${Object.keys(PLATFORMS).join(", ")}`
+  );
+}
+
+let nativeModule;
+try {
+  nativeModule = require(pkg);
+} catch {
+  try {
+    const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+    nativeModule = require(path.join(pkgDir, "dotsec-core.node"));
+  } catch {
+    try {
+      nativeModule = require(path.join(__dirname, "dotsec-core.node"));
+    } catch {
+      throw new Error(
+        `@dotsec/core: could not load native module "${pkg}"\n\n` +
+        `This usually means the optional dependency was not installed.\n` +
+        `Try reinstalling with: npm install @dotsec/core`
+      );
+    }
+  }
+}
+
+export const { parse, validate, toJson, format } = nativeModule;
+export default nativeModule;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@dotsec/core",
+  "version": "5.0.0-beta.04208ad",
+  "description": "Native Node.js bindings for dotsec — parse, validate, and format .env files",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "binaryName": "dotsec-core",
+    "targets": [
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc",
+      "aarch64-pc-windows-msvc"
+    ]
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jpwesselink/dotsec-rs"
+  },
+  "optionalDependencies": {
+    "@dotsec/core-darwin-arm64": "5.0.0-beta.04208ad",
+    "@dotsec/core-darwin-x64": "5.0.0-beta.04208ad",
+    "@dotsec/core-linux-x64-gnu": "5.0.0-beta.04208ad",
+    "@dotsec/core-linux-arm64-gnu": "5.0.0-beta.04208ad",
+    "@dotsec/core-win32-x64-msvc": "5.0.0-beta.04208ad",
+    "@dotsec/core-win32-arm64-msvc": "5.0.0-beta.04208ad"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}