@helios-lang/effect 0.1.0

package/src/internal/Utf8.ts

@@ -0,0 +1,58 @@
+import { Effect, Encoding } from "effect"
+import * as Bytes from "./Bytes.js"
+
+/**
+ * Decodes a list of uint8 bytes into a string using UTF-8 encoding.
+ * @example
+ * bytesToUtf8([104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]) == "hello world"
+ * @param bytes
+ * @returns
+ */
+export function decode(
+  bytes: string | number[] | Uint8Array
+): Effect.Effect<string, Encoding.DecodeException> {
+  return Effect.sync(() =>
+    new TextDecoder("utf-8", { fatal: true }).decode(
+      Bytes.toUint8Array(bytes).buffer
+    )
+  ).pipe(
+    Effect.catchAll(() =>
+      Effect.fail(Bytes.DecodeException(bytes, "Invalid utf-8 encoding"))
+    )
+  )
+}
+
+/**
+ * Encodes a string into a list of uint8 bytes using UTF-8 encoding.
+ * @example
+ * utf8ToBytes("hello world") == [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]
+ * @param str
+ * @returns
+ */
+export function encode(str: string): Uint8Array {
+  return new TextEncoder().encode(str)
+}
+
+/**
+ * Tests if a uint8 array is valid utf8 encoding.
+ * @param {number[]} bytes
+ * @returns {boolean}
+ */
+export function isValid(bytes: string | number[] | Uint8Array): boolean {
+  /**
+   * Bytes.toArray() doesn't fail if any of the bytes are out of range
+   */
+  const bs = Bytes.toArray(bytes)
+
+  if (bs.some((b) => b < 0 || b > 255)) {
+    return false
+  }
+
+  try {
+    new TextDecoder("utf-8", { fatal: true }).decode(new Uint8Array(bs).buffer)
+
+    return true
+  } catch (_e) {
+    return false
+  }
+}

package/tsconfig.build.json

@@ -0,0 +1,14 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "noEmit": false,
+    "declaration": true,
+    "declarationMap": true,
+    "declarationDir": "./types",
+    "sourceMap": true,
+    "removeComments": false
+  },
+  "exclude": ["node_modules", "**/*.d.ts", "**/*.test.ts"],
+  "include": ["src/**/*.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "rootDir": "src",
+    "declarationMap": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "noImplicitThis": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "moduleResolution": "node",
+    "module": "esnext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "exactOptionalPropertyTypes": true,
+    "moduleDetection": "force",
+    "composite": true,
+    "downlevelIteration": true,
+    "esModuleInterop": false,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "types": ["bun"],
+    "isolatedModules": true,
+    "noImplicitReturns": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "noEmitOnError": false,
+    "noErrorTruncation": false,
+    "allowJs": false,
+    "checkJs": false,
+    "forceConsistentCasingInFileNames": true,
+    "noUncheckedIndexedAccess": false,
+    "incremental": true
+  },
+  "exclude": ["node_modules", "**/*.d.ts"],
+  "include": ["src/**/*.ts"]
+}