lltz 1.0.0 → 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": "1.0.0",
+  "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": [
@@ -26,6 +26,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
+    "./server": "./dist/server.js",
     "./data/*": "./data/*"
   },
   "files": [