lltz 0.0.1 → 1.1.0

package/README.md

@@ -28,6 +28,21 @@ The other variants, `timezones-1970.lltz` and `timezones-now.lltz`, can be downl
 
 ### Node.js / Bun
 
+#### Simple Usage
+
+```typescript
+import * as Lltz from 'lltz/server'
+
+const lookup = Lltz.make() // Automatically loads the built-in timezones.lltz file
+
+const timezones = lookup(40.7128, -74.006) // New York
+console.log(timezones) // ['America/New_York']
+```
+
+#### Manual Data Loading
+
+If you need to use a different data file or have custom requirements:
+
 ```typescript
 import fs from 'node:fs'
 

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+import { Lookup } from "./index.js";
+
+//#region src/server.d.ts
+
+/**
+ * Creates a timezone lookup function from the provided binary data.
+ *
+ * @param arrayBufferOrUint8Array - Optional binary data containing the timezone database (LLTZ
+ * format). If not provided, the built-in `timezones.lltz` file will be automatically loaded.
+ * @returns {Lookup} A timezone lookup function.
+ * @throws An error if the binary data is invalid or if the built-in data file cannot be loaded.
+ */
+declare const make: (arrayBufferOrUint8Array?: ArrayBuffer | Uint8Array) => Lookup;
+//#endregion
+export { type Lookup, make };

package/dist/server.js

@@ -0,0 +1,28 @@
+import { make as make$1 } from "./index.js";
+import fs from "node:fs";
+
+//#region src/server.ts
+const load = () => {
+	try {
+		return fs.readFileSync(new URL(import.meta.resolve("lltz/data/timezones.lltz")));
+	} catch {}
+	try {
+		return fs.readFileSync(new URL("../data/timezones.lltz", import.meta.url));
+	} catch {}
+	try {
+		return fs.readFileSync("node_modules/lltz/data/timezones.lltz");
+	} catch {}
+	throw new Error("failed to load built-in timezones.lltz file");
+};
+/**
+* Creates a timezone lookup function from the provided binary data.
+*
+* @param arrayBufferOrUint8Array - Optional binary data containing the timezone database (LLTZ
+* format). If not provided, the built-in `timezones.lltz` file will be automatically loaded.
+* @returns {Lookup} A timezone lookup function.
+* @throws An error if the binary data is invalid or if the built-in data file cannot be loaded.
+*/
+const make = (arrayBufferOrUint8Array) => make$1(arrayBufferOrUint8Array ?? load());
+
+//#endregion
+export { make };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lltz",
-  "version": "0.0.1",
+  "version": "1.1.0",
   "author": "Utkarsh Kukreti <utkarshkukreti@gmail.com>",
   "description": "A high-performance, memory-efficient offline timezone lookup library for TypeScript using a custom binary format and quadtree spatial indexing.",
   "keywords": [
@@ -20,17 +20,28 @@
   },
   "license": "MIT",
   "type": "module",
+  "packageManager": "pnpm@10.28.0",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
+    "./server": "./dist/server.js",
     "./data/*": "./data/*"
   },
   "files": [
     "data/timezones.lltz",
     "dist"
   ],
+  "scripts": {
+    "build": "tsc && tsdown",
+    "prepublishOnly": "make && pnpm build",
+    "lint": "prettier --check .",
+    "format": "prettier --write .",
+    "test": "node --max-old-space-size=8192 tests/index.ts",
+    "bench": "node benches/index.ts",
+    "bench:memory": "node benches/memory.ts lltz:timezones && node benches/memory.ts geo-tz:timezones"
+  },
   "devDependencies": {
     "@ianvs/prettier-plugin-sort-imports": "4.7.0",
     "@types/node": "24.10.8",
@@ -39,13 +50,5 @@
     "tinybench": "6.0.0",
     "tsdown": "0.19.0",
     "typescript": "5.9.3"
-  },
-  "scripts": {
-    "build": "tsc && tsdown",
-    "lint": "prettier --check .",
-    "format": "prettier --write .",
-    "test": "node --max-old-space-size=8192 tests/index.ts",
-    "bench": "node benches/index.ts",
-    "bench:memory": "node benches/memory.ts lltz:timezones && node benches/memory.ts geo-tz:timezones"
   }
-}
+}