@onreza/runtime 0.2.0

package/README.md

@@ -0,0 +1,153 @@
+# @onreza/runtime
+
+Runtime SDK for ONREZA platform APIs with TypeScript support.
+
+## Установка
+
+```bash
+bun add @onreza/runtime
+```
+
+## Модули
+
+### `@onreza/runtime/kv`
+
+KV store (namespace-isolated):
+
+```typescript
+import { kv, isKVAvailable } from '@onreza/runtime/kv';
+
+// Check availability (optional)
+if (isKVAvailable()) {
+  // Set with TTL
+  await kv.set('session:123', { userId: '456' }, { ttl: 3600 });
+
+  // Get as JSON
+  const user = await kv.get('user:123', { type: 'json' });
+
+  // Check existence
+  const exists = await kv.has('user:123');
+
+  // Delete
+  await kv.delete('session:123');
+
+  // List keys with prefix
+  const { keys, cursor } = await kv.list({ prefix: 'user:', limit: 50 });
+}
+```
+
+### `@onreza/runtime/db`
+
+D1-compatible database:
+
+```typescript
+import { db, isDBAvailable } from '@onreza/runtime/db';
+
+if (isDBAvailable()) {
+  // Prepare and execute query
+  const stmt = db.prepare('SELECT * FROM users WHERE id = ?');
+  const { results } = await stmt.bind(1).all();
+
+  // Get first row
+  const user = await db.prepare('SELECT * FROM users WHERE id = ?').bind(1).first();
+
+  // Insert
+  await db.prepare('INSERT INTO users (name) VALUES (?)').bind('Alice').run();
+
+  // Batch operations
+  const stmt1 = db.prepare('UPDATE users SET name = ? WHERE id = ?').bind('Bob', 1);
+  const stmt2 = db.prepare('UPDATE users SET name = ? WHERE id = ?').bind('Charlie', 2);
+  await db.batch([stmt1, stmt2]);
+}
+```
+
+### `@onreza/runtime/context`
+
+Request context and geolocation:
+
+```typescript
+import { getContext, isContextAvailable, getClientIp, getGeo, getRequestId } from '@onreza/runtime/context';
+
+if (isContextAvailable()) {
+  // Get full context
+  const ctx = getContext();
+  console.log(ctx.geo?.city);     // 'Moscow'
+  console.log(ctx.geo?.country);  // 'RU'
+  console.log(ctx.clientIp);      // '1.2.3.4'
+  console.log(ctx.requestId);     // UUID v7
+
+  // Or use shortcuts
+  const ip = getClientIp();
+  const geo = getGeo();
+  const requestId = getRequestId();
+}
+```
+
+### `@onreza/runtime/env`
+
+Environment variables:
+
+```typescript
+import { env, isEnvAvailable, getEnv } from '@onreza/runtime/env';
+
+if (isEnvAvailable()) {
+  // Get required variable (throws if missing)
+  const apiKey = env.get('API_KEY');
+
+  // Get with default
+  const timeout = getEnv('TIMEOUT', '5000');
+
+  // Check existence
+  if (env.has('DEBUG')) {
+    console.log('Debug mode enabled');
+  }
+
+  // Iterate all variables
+  for (const [key, value] of env.entries()) {
+    console.log(`${key}=${value}`);
+  }
+}
+```
+
+### `@onreza/runtime/image`
+
+Image optimization URL builder:
+
+```typescript
+import { imageUrl, generateSrcset, DEFAULT_SIZES } from '@onreza/runtime/image';
+
+// Basic usage
+const url = imageUrl('/images/hero.jpg', { width: 1080 });
+// → '/_onreza/image?url=%2Fimages%2Fhero.jpg&w=1080&q=75'
+
+// With all options
+const optimized = imageUrl('/images/photo.jpg', {
+  width: 640,
+  height: 480,
+  quality: 80,
+  format: 'webp',
+  fit: 'cover',
+  blur: 10,
+  dpr: 2
+});
+
+// Generate srcset for responsive images
+const srcset = generateSrcset('/images/photo.jpg', [640, 1080, 1920], { quality: 80 });
+// → '/_onreza/image?url=...&w=640&q=80 640w, /_onreza/image?url=...&w=1080&q=80 1080w, ...'
+```
+
+### `@onreza/runtime/types`
+
+All types combined:
+
+```typescript
+/// <reference types="@onreza/runtime/types" />
+
+// Or import specific types
+import type { KVStore, D1Database, OnrezaContext } from '@onreza/runtime/types';
+```
+
+## Требования
+
+- TypeScript 5.0+
+- ONREZA runtime environment (edge runtime)

package/dist/context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ONREZA Request Context SDK
+ *
+ * Utilities for accessing request context and geolocation
+ *
+ * @example
+ * ```typescript
+ * import { getContext, isContextAvailable } from '@onreza/runtime/context';
+ *
+ * if (isContextAvailable()) {
+ *   const ctx = getContext();
+ *   console.log(ctx.geo?.city);
+ *   console.log(ctx.requestId);
+ * }
+ * ```
+ */
+import type { OnrezaContext, OnrezaGeo } from "../types.d.ts";
+/**
+ * Check if request context is available
+ *
+ * @returns true if ONREZA.context is available
+ */
+export declare function isContextAvailable(): boolean;
+/**
+ * Get the ONREZA request context
+ * @throws Error if not running in ONREZA runtime
+ */
+export declare function getContext(): OnrezaContext;
+/**
+ * Get client IP from context
+ * @returns Client IP or null if not available
+ */
+export declare function getClientIp(): string | null;
+/**
+ * Get GeoIP data from context
+ * @returns Geo data or null if not available
+ */
+export declare function getGeo(): OnrezaGeo | null;
+/**
+ * Get request ID from context
+ * @returns Request ID or null if not available
+ */
+export declare function getRequestId(): string | null;
+export type { OnrezaContext, OnrezaGeo } from "../types.d.ts";
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAS9D;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAM1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAG3C;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,SAAS,GAAG,IAAI,CAGzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAG5C;AAGD,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/context.js

@@ -0,0 +1,69 @@
+/**
+ * ONREZA Request Context SDK
+ *
+ * Utilities for accessing request context and geolocation
+ *
+ * @example
+ * ```typescript
+ * import { getContext, isContextAvailable } from '@onreza/runtime/context';
+ *
+ * if (isContextAvailable()) {
+ *   const ctx = getContext();
+ *   console.log(ctx.geo?.city);
+ *   console.log(ctx.requestId);
+ * }
+ * ```
+ */
+/**
+ * Check if running in ONREZA runtime environment
+ */
+function isOnrezaRuntime() {
+    return typeof globalThis.ONREZA !== "undefined";
+}
+/**
+ * Check if request context is available
+ *
+ * @returns true if ONREZA.context is available
+ */
+export function isContextAvailable() {
+    return isOnrezaRuntime() && !!globalThis.ONREZA?.context;
+}
+/**
+ * Get the ONREZA request context
+ * @throws Error if not running in ONREZA runtime
+ */
+export function getContext() {
+    const onreza = globalThis.ONREZA;
+    if (!onreza?.context) {
+        throw new Error("ONREZA context is not available. " + "Make sure you are running in ONREZA runtime.");
+    }
+    return onreza.context;
+}
+/**
+ * Get client IP from context
+ * @returns Client IP or null if not available
+ */
+export function getClientIp() {
+    if (!isContextAvailable())
+        return null;
+    return getContext().clientIp;
+}
+/**
+ * Get GeoIP data from context
+ * @returns Geo data or null if not available
+ */
+export function getGeo() {
+    if (!isContextAvailable())
+        return null;
+    return getContext().geo;
+}
+/**
+ * Get request ID from context
+ * @returns Request ID or null if not available
+ */
+export function getRequestId() {
+    if (!isContextAvailable())
+        return null;
+    return getContext().requestId;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO,OAAQ,UAAmC,CAAC,MAAM,KAAK,WAAW,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,EAAE,IAAI,CAAC,CAAE,UAAiD,CAAC,MAAM,EAAE,OAAO,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAI,UAAuD,CAAC,MAAM,CAAC;IAC/E,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,8CAA8C,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,UAAU,EAAE,CAAC,QAAQ,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,UAAU,EAAE,CAAC,GAAG,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC;AAChC,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ONREZA D1 Database SDK
+ *
+ * Types and wrappers for ONREZA.db platform API
+ * Compatible with Cloudflare D1
+ *
+ * @example
+ * ```typescript
+ * import { db, isDBAvailable } from '@onreza/runtime/db';
+ *
+ * if (isDBAvailable()) {
+ *   // Prepare and execute query
+ *   const stmt = db.prepare('SELECT * FROM users WHERE id = ?');
+ *   const { results } = await stmt.bind(1).all();
+ *
+ *   // Get first row
+ *   const user = await db.prepare('SELECT * FROM users WHERE id = ?').bind(1).first();
+ *
+ *   // Insert
+ *   await db.prepare('INSERT INTO users (name) VALUES (?)').bind('Alice').run();
+ * }
+ * ```
+ */
+import type { D1Database } from "../types.d.ts";
+/**
+ * D1 Database operations
+ *
+ * Note: In ONREZA runtime, this uses the platform-injected ONREZA.db.
+ * Outside runtime, operations throw an error.
+ */
+export declare const db: Pick<D1Database, "batch" | "exec" | "prepare">;
+/**
+ * Check if D1 database is available in the current environment
+ *
+ * @returns true if ONREZA.db is available
+ */
+export declare function isDBAvailable(): boolean;
+export type { D1Database, D1PreparedStatement, D1Result } from "../types.d.ts";
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,eAAe,CAAC;AAwB/E;;;;;GAKG;AACH,eAAO,MAAM,EAAE,EAyBV,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAGD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/db.js

@@ -0,0 +1,81 @@
+/**
+ * ONREZA D1 Database SDK
+ *
+ * Types and wrappers for ONREZA.db platform API
+ * Compatible with Cloudflare D1
+ *
+ * @example
+ * ```typescript
+ * import { db, isDBAvailable } from '@onreza/runtime/db';
+ *
+ * if (isDBAvailable()) {
+ *   // Prepare and execute query
+ *   const stmt = db.prepare('SELECT * FROM users WHERE id = ?');
+ *   const { results } = await stmt.bind(1).all();
+ *
+ *   // Get first row
+ *   const user = await db.prepare('SELECT * FROM users WHERE id = ?').bind(1).first();
+ *
+ *   // Insert
+ *   await db.prepare('INSERT INTO users (name) VALUES (?)').bind('Alice').run();
+ * }
+ * ```
+ */
+/**
+ * Check if running in ONREZA runtime environment
+ */
+function isOnrezaRuntime() {
+    return typeof globalThis.ONREZA !== "undefined";
+}
+/**
+ * Get the ONREZA D1 database instance
+ * @throws Error if not running in ONREZA runtime
+ */
+function getDatabase() {
+    const onreza = globalThis.ONREZA;
+    if (!onreza?.db) {
+        throw new Error("ONREZA D1 database is not available. " +
+            'Make sure you are running in ONREZA runtime and have "bindings.db: true" in your manifest.');
+    }
+    return onreza.db;
+}
+/**
+ * D1 Database operations
+ *
+ * Note: In ONREZA runtime, this uses the platform-injected ONREZA.db.
+ * Outside runtime, operations throw an error.
+ */
+export const db = {
+    /**
+     * Batch execute statements atomically
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for D1Database API
+    async batch(statements) {
+        const database = getDatabase();
+        return database.batch(statements);
+    },
+    /**
+     * Execute multiple statements (DDL)
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for D1Database API
+    async exec(query) {
+        const database = getDatabase();
+        return database.exec(query);
+    },
+    /**
+     * Prepare a SQL statement
+     */
+    prepare(query) {
+        const database = getDatabase();
+        return database.prepare(query);
+    },
+};
+/**
+ * Check if D1 database is available in the current environment
+ *
+ * @returns true if ONREZA.db is available
+ */
+export function isDBAvailable() {
+    return isOnrezaRuntime() && !!globalThis.ONREZA?.db;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO,OAAQ,UAAmC,CAAC,MAAM,KAAK,WAAW,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,MAAM,GAAI,UAA+C,CAAC,MAAM,CAAC;IACvE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,uCAAuC;YACrC,4FAA4F,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB;;OAEG;IACH,oEAAoE;IACpE,KAAK,CAAC,KAAK,CAAc,UAAiC;QACxD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD;;OAEG;IACH,oEAAoE;IACpE,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa;QACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACgD,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,EAAE,IAAI,CAAC,CAAE,UAA4C,CAAC,MAAM,EAAE,EAAE,CAAC;AACzF,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ONREZA Environment SDK
+ *
+ * Utilities for accessing environment variables
+ *
+ * @example
+ * ```typescript
+ * import { env, isEnvAvailable, getEnv } from '@onreza/runtime/env';
+ *
+ * if (isEnvAvailable()) {
+ *   // Get required variable (throws if missing)
+ *   const apiKey = env.get('API_KEY');
+ *
+ *   // Get with default
+ *   const timeout = getEnv('TIMEOUT', '5000');
+ *
+ *   // Check existence
+ *   if (env.has('DEBUG')) {
+ *     console.log('Debug mode enabled');
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Environment variable operations
+ */
+export declare const env: {
+    /**
+     * Iterate over all environment variables
+     */
+    entries(): IterableIterator<[string, string]>;
+    /**
+     * Get environment variable
+     * @param key - Variable name
+     * @returns Value or undefined if not set
+     */
+    get(key: string): string | undefined;
+    /**
+     * Check if environment variable exists
+     * @param key - Variable name
+     * @returns true if exists
+     */
+    has(key: string): boolean;
+};
+/**
+ * Check if env store is available
+ * @returns true if ONREZA.env is available
+ */
+export declare function isEnvAvailable(): boolean;
+/**
+ * Get environment variable with default value
+ * @param key - Variable name
+ * @param defaultValue - Default if not set
+ * @returns Value or default
+ */
+export declare function getEnv(key: string, defaultValue: string): string;
+export type { EnvStore } from "../types.d.ts";
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAuBH;;GAEG;AACH,eAAO,MAAM,GAAG;IACd;;OAEG;eACQ,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAG7C;;;;OAIG;aACM,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC;;;;OAIG;aACM,MAAM,GAAG,OAAO;CAG1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAGhE;AAGD,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/env.js

@@ -0,0 +1,86 @@
+/**
+ * ONREZA Environment SDK
+ *
+ * Utilities for accessing environment variables
+ *
+ * @example
+ * ```typescript
+ * import { env, isEnvAvailable, getEnv } from '@onreza/runtime/env';
+ *
+ * if (isEnvAvailable()) {
+ *   // Get required variable (throws if missing)
+ *   const apiKey = env.get('API_KEY');
+ *
+ *   // Get with default
+ *   const timeout = getEnv('TIMEOUT', '5000');
+ *
+ *   // Check existence
+ *   if (env.has('DEBUG')) {
+ *     console.log('Debug mode enabled');
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Check if running in ONREZA runtime environment
+ */
+function isOnrezaRuntime() {
+    return typeof globalThis.ONREZA !== "undefined";
+}
+/**
+ * Get the ONREZA env store instance
+ * @throws Error if not running in ONREZA runtime
+ */
+function getEnvStore() {
+    const onreza = globalThis.ONREZA;
+    if (!onreza?.env) {
+        throw new Error("ONREZA env is not available. Make sure you are running in ONREZA runtime.");
+    }
+    return onreza.env;
+}
+/**
+ * Environment variable operations
+ */
+export const env = {
+    /**
+     * Iterate over all environment variables
+     */
+    entries() {
+        return getEnvStore().entries();
+    },
+    /**
+     * Get environment variable
+     * @param key - Variable name
+     * @returns Value or undefined if not set
+     */
+    get(key) {
+        return getEnvStore().get(key);
+    },
+    /**
+     * Check if environment variable exists
+     * @param key - Variable name
+     * @returns true if exists
+     */
+    has(key) {
+        return getEnvStore().has(key);
+    },
+};
+/**
+ * Check if env store is available
+ * @returns true if ONREZA.env is available
+ */
+export function isEnvAvailable() {
+    return isOnrezaRuntime() && !!globalThis.ONREZA?.env;
+}
+/**
+ * Get environment variable with default value
+ * @param key - Variable name
+ * @param defaultValue - Default if not set
+ * @returns Value or default
+ */
+export function getEnv(key, defaultValue) {
+    if (!isEnvAvailable())
+        return defaultValue;
+    return env.get(key) ?? defaultValue;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO,OAAQ,UAAmC,CAAC,MAAM,KAAK,WAAW,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,MAAM,GAAI,UAA8C,CAAC,MAAM,CAAC;IACtE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB;;OAEG;IACH,OAAO;QACL,OAAO,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IACD;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,EAAE,IAAI,CAAC,CAAE,UAA6C,CAAC,MAAM,EAAE,GAAG,CAAC;AAC3F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,YAAoB;IACtD,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,YAAY,CAAC;IAC3C,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;AACtC,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,92 @@
+/**
+ * ONREZA Image Optimization SDK
+ *
+ * URL builder for platform image optimization service
+ * Endpoint: /_onreza/image
+ *
+ * @example
+ * ```typescript
+ * import { imageUrl, generateSrcset, DEFAULT_SIZES } from '@onreza/runtime/image';
+ *
+ * // Basic usage
+ * const url = imageUrl('/images/hero.jpg', { width: 1080 });
+ * // → '/_onreza/image?url=%2Fimages%2Fhero.jpg&w=1080&q=75'
+ *
+ * // With quality and format
+ * const optimized = imageUrl('/images/photo.jpg', {
+ *   width: 640,
+ *   quality: 80,
+ *   format: 'webp'
+ * });
+ *
+ * // Generate srcset for responsive images
+ * const srcset = generateSrcset('/images/photo.jpg', [640, 1080, 1920]);
+ * // → '/_onreza/image?url=...&w=640 640w, /_onreza/image?url=...&w=1080 1080w, ...'
+ * ```
+ */
+/** Default platform image sizes */
+export declare const DEFAULT_SIZES: readonly [640, 750, 828, 1080, 1200, 1920, 2048, 3840];
+/** Supported image formats */
+export type ImageFormat = "webp" | "avif";
+/** Resize fit modes */
+export type ImageFit = "cover" | "contain" | "fill";
+/**
+ * Image transformation options
+ */
+export interface ImageTransformOptions {
+    /** Target width in pixels (must be from allowed sizes) */
+    width?: number;
+    /** Target height in pixels (optional, maintains aspect ratio by default) */
+    height?: number;
+    /** Quality 1-100 (default: 75) */
+    quality?: number;
+    /** Output format (default: auto from Accept header) */
+    format?: ImageFormat;
+    /** Resize fit mode (default: 'cover') */
+    fit?: ImageFit;
+    /** Gaussian blur sigma 0-250 (default: 0) */
+    blur?: number;
+    /** Device Pixel Ratio 1-5 (default: 1) - multiplies width/height */
+    dpr?: number;
+}
+/**
+ * Build ONREZA image optimization URL
+ *
+ * @param src - Relative image path (e.g., "/images/photo.jpg")
+ * @param options - Transformation options
+ * @returns Optimized image URL
+ * @throws Error if src is absolute URL or contains path traversal
+ *
+ * @example
+ * ```typescript
+ * imageUrl('/images/hero.jpg', { width: 1080 })
+ * // → '/_onreza/image?url=%2Fimages%2Fhero.jpg&w=1080&q=75'
+ *
+ * imageUrl('/images/photo.jpg', { width: 640, quality: 80, format: 'webp', blur: 10 })
+ * // → '/_onreza/image?url=%2Fimages%2Fphoto.jpg&w=640&q=80&f=webp&blur=10'
+ * ```
+ */
+export declare function imageUrl(src: string, options?: ImageTransformOptions): string;
+/**
+ * Validate and normalize image options
+ *
+ * @param options - Raw options
+ * @returns Normalized options with valid values
+ */
+export declare function validateImageOptions(options: ImageTransformOptions): Required<Pick<ImageTransformOptions, "quality" | "blur" | "dpr" | "fit">> & Pick<ImageTransformOptions, "width" | "height" | "format">;
+/**
+ * Generate responsive srcset attribute
+ *
+ * @param src - Relative image path
+ * @param widths - Array of desired widths (will be normalized to allowed sizes)
+ * @param options - Base options (applied to all sizes)
+ * @returns srcset string for img srcset attribute
+ *
+ * @example
+ * ```typescript
+ * generateSrcset('/images/photo.jpg', [640, 1080, 1920], { quality: 80 })
+ * // → '/_onreza/image?url=...&w=640&q=80 640w, /_onreza/image?url=...&w=1080&q=80 1080w, ...'
+ * ```
+ */
+export declare function generateSrcset(src: string, widths: number[], options?: Omit<ImageTransformOptions, "width">): string;
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mCAAmC;AACnC,eAAO,MAAM,aAAa,wDAAyD,CAAC;AAEpF,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,uBAAuB;AACvB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yCAAyC;IACzC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAyCjF;AASD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,GAC1E,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAU3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAM,GACjD,MAAM,CAQR"}

package/dist/image.js

@@ -0,0 +1,150 @@
+/**
+ * ONREZA Image Optimization SDK
+ *
+ * URL builder for platform image optimization service
+ * Endpoint: /_onreza/image
+ *
+ * @example
+ * ```typescript
+ * import { imageUrl, generateSrcset, DEFAULT_SIZES } from '@onreza/runtime/image';
+ *
+ * // Basic usage
+ * const url = imageUrl('/images/hero.jpg', { width: 1080 });
+ * // → '/_onreza/image?url=%2Fimages%2Fhero.jpg&w=1080&q=75'
+ *
+ * // With quality and format
+ * const optimized = imageUrl('/images/photo.jpg', {
+ *   width: 640,
+ *   quality: 80,
+ *   format: 'webp'
+ * });
+ *
+ * // Generate srcset for responsive images
+ * const srcset = generateSrcset('/images/photo.jpg', [640, 1080, 1920]);
+ * // → '/_onreza/image?url=...&w=640 640w, /_onreza/image?url=...&w=1080 1080w, ...'
+ * ```
+ */
+/** Default platform image sizes */
+export const DEFAULT_SIZES = [640, 750, 828, 1080, 1200, 1920, 2048, 3840];
+/**
+ * Validate image source path
+ * @throws Error if path is invalid
+ */
+function validateSrc(src) {
+    // Reject absolute URLs
+    if (src.startsWith("http://") || src.startsWith("https://") || src.startsWith("//")) {
+        throw new Error(`Image source must be a relative path, got: ${src}`);
+    }
+    // Path traversal protection
+    const normalized = src.replace(/\\/g, "/");
+    if (normalized.includes("..") ||
+        normalized.includes("%2e") ||
+        normalized.includes("%2E") ||
+        normalized.includes("%252e") ||
+        normalized.includes("%252E")) {
+        throw new Error(`Path traversal detected in image source: ${src}`);
+    }
+}
+/**
+ * Clamp value to range
+ */
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Build ONREZA image optimization URL
+ *
+ * @param src - Relative image path (e.g., "/images/photo.jpg")
+ * @param options - Transformation options
+ * @returns Optimized image URL
+ * @throws Error if src is absolute URL or contains path traversal
+ *
+ * @example
+ * ```typescript
+ * imageUrl('/images/hero.jpg', { width: 1080 })
+ * // → '/_onreza/image?url=%2Fimages%2Fhero.jpg&w=1080&q=75'
+ *
+ * imageUrl('/images/photo.jpg', { width: 640, quality: 80, format: 'webp', blur: 10 })
+ * // → '/_onreza/image?url=%2Fimages%2Fphoto.jpg&w=640&q=80&f=webp&blur=10'
+ * ```
+ */
+export function imageUrl(src, options = {}) {
+    validateSrc(src);
+    const params = new URLSearchParams();
+    params.set("url", src);
+    // Width (required)
+    if (options.width !== undefined) {
+        params.set("w", String(options.width));
+    }
+    // Height (optional)
+    if (options.height !== undefined) {
+        params.set("h", String(options.height));
+    }
+    // Quality (default: 75)
+    const quality = options.quality !== undefined ? clamp(options.quality, 1, 100) : 75;
+    params.set("q", String(quality));
+    // Format (optional)
+    if (options.format) {
+        params.set("f", options.format);
+    }
+    // Fit mode (optional, default: cover)
+    if (options.fit && options.fit !== "cover") {
+        params.set("fit", options.fit);
+    }
+    // Blur (optional, 0-250)
+    if (options.blur !== undefined && options.blur > 0) {
+        params.set("blur", String(clamp(options.blur, 0, 250)));
+    }
+    // DPR (optional, 1-5)
+    if (options.dpr !== undefined && options.dpr !== 1) {
+        params.set("dpr", String(clamp(options.dpr, 1, 5)));
+    }
+    return `/_onreza/image?${params.toString()}`;
+}
+/**
+ * Find nearest allowed width from DEFAULT_SIZES
+ */
+function findNearestWidth(width) {
+    return DEFAULT_SIZES.reduce((prev, curr) => (Math.abs(curr - width) < Math.abs(prev - width) ? curr : prev));
+}
+/**
+ * Validate and normalize image options
+ *
+ * @param options - Raw options
+ * @returns Normalized options with valid values
+ */
+export function validateImageOptions(options) {
+    return {
+        blur: clamp(options.blur ?? 0, 0, 250),
+        dpr: clamp(options.dpr ?? 1, 1, 5),
+        fit: options.fit ?? "cover",
+        format: options.format,
+        height: options.height,
+        quality: clamp(options.quality ?? 75, 1, 100),
+        width: options.width !== undefined ? findNearestWidth(options.width) : undefined,
+    };
+}
+/**
+ * Generate responsive srcset attribute
+ *
+ * @param src - Relative image path
+ * @param widths - Array of desired widths (will be normalized to allowed sizes)
+ * @param options - Base options (applied to all sizes)
+ * @returns srcset string for img srcset attribute
+ *
+ * @example
+ * ```typescript
+ * generateSrcset('/images/photo.jpg', [640, 1080, 1920], { quality: 80 })
+ * // → '/_onreza/image?url=...&w=640&q=80 640w, /_onreza/image?url=...&w=1080&q=80 1080w, ...'
+ * ```
+ */
+export function generateSrcset(src, widths, options = {}) {
+    return widths
+        .map((width) => {
+        const nearest = findNearestWidth(width);
+        const url = imageUrl(src, { ...options, width: nearest });
+        return `${url} ${nearest}w`;
+    })
+        .join(", ");
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AA4BpF;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,uBAAuB;IACvB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,IACE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QACzB,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4CAA4C,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,UAAiC,EAAE;IACvE,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvB,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,wBAAwB;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjC,oBAAoB;IACpB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,sCAAsC;IACtC,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,kBAAkB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAG9B,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;QACtC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC;QAC7C,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KACjF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,MAAgB,EAChB,UAAgD,EAAE;IAElD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,OAAO,GAAG,GAAG,IAAI,OAAO,GAAG,CAAC;IAC9B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/kv.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ONREZA KV Store SDK
+ *
+ * Types and wrappers for ONREZA.kv platform API
+ *
+ * @example
+ * ```typescript
+ * import { kv, isKVAvailable } from '@onreza/runtime/kv';
+ *
+ * // Check availability (optional)
+ * if (isKVAvailable()) {
+ *   // Set with TTL
+ *   await kv.set('session:123', { userId: '456' }, { ttl: 3600 });
+ *
+ *   // Get as JSON
+ *   const user = await kv.get('user:123', { type: 'json' });
+ * }
+ * ```
+ */
+import type { KVStore } from "../types.d.ts";
+/**
+ * KV store operations
+ *
+ * Note: In ONREZA runtime, this uses the platform-injected ONREZA.kv.
+ * Outside runtime, operations throw an error.
+ */
+export declare const kv: KVStore;
+/**
+ * Check if KV store is available in the current environment
+ *
+ * @returns true if ONREZA.kv is available
+ */
+export declare function isKVAvailable(): boolean;
+export type { KVGetOptions, KVListOptions, KVListResult, KVSetOptions, KVStore } from "../types.d.ts";
+//# sourceMappingURL=kv.d.ts.map

package/dist/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAA2D,OAAO,EAAE,MAAM,eAAe,CAAC;AAwBtG;;;;;GAKG;AACH,eAAO,MAAM,EAAE,EA8FV,OAAO,CAAC;AAEb;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAGD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/kv.js

@@ -0,0 +1,144 @@
+/**
+ * ONREZA KV Store SDK
+ *
+ * Types and wrappers for ONREZA.kv platform API
+ *
+ * @example
+ * ```typescript
+ * import { kv, isKVAvailable } from '@onreza/runtime/kv';
+ *
+ * // Check availability (optional)
+ * if (isKVAvailable()) {
+ *   // Set with TTL
+ *   await kv.set('session:123', { userId: '456' }, { ttl: 3600 });
+ *
+ *   // Get as JSON
+ *   const user = await kv.get('user:123', { type: 'json' });
+ * }
+ * ```
+ */
+/**
+ * Check if running in ONREZA runtime environment
+ */
+function isOnrezaRuntime() {
+    return typeof globalThis.ONREZA !== "undefined";
+}
+/**
+ * Get the ONREZA KV store instance
+ * @throws Error if not running in ONREZA runtime
+ */
+function getKVStore() {
+    const onreza = globalThis.ONREZA;
+    if (!onreza?.kv) {
+        throw new Error("ONREZA KV store is not available. " +
+            'Make sure you are running in ONREZA runtime and have "bindings.kv: true" in your manifest.');
+    }
+    return onreza.kv;
+}
+/**
+ * KV store operations
+ *
+ * Note: In ONREZA runtime, this uses the platform-injected ONREZA.kv.
+ * Outside runtime, operations throw an error.
+ */
+export const kv = {
+    /**
+     * Delete a key from the KV store
+     *
+     * @param key - The key to delete
+     * @returns true if key existed and was deleted, false otherwise
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for KVStore API
+    async delete(key) {
+        const store = getKVStore();
+        return store.delete(key);
+    },
+    /**
+     * Get a value from the KV store
+     *
+     * @param key - The key to retrieve
+     * @param options - Get options (type: 'text' | 'json' | 'arrayBuffer')
+     * @returns The value or null if not found
+     *
+     * @example
+     * ```typescript
+     * // Get as string (default)
+     * const value = await kv.get('my-key');
+     *
+     * // Get as JSON
+     * const data = await kv.get('user:123', { type: 'json' });
+     * ```
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for KVStore API
+    async get(key, options) {
+        const store = getKVStore();
+        return store.get(key, options);
+    },
+    /**
+     * Check if a key exists in the KV store
+     *
+     * @param key - The key to check
+     * @returns true if key exists, false otherwise
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for KVStore API
+    async has(key) {
+        const store = getKVStore();
+        return store.has(key);
+    },
+    /**
+     * List keys in the KV store with optional filtering
+     *
+     * @param options - List options (prefix, limit, cursor)
+     * @returns Object with keys array and optional cursor for pagination
+     *
+     * @example
+     * ```typescript
+     * // List first 50 keys with prefix
+     * const { keys, cursor } = await kv.list({ prefix: 'user:', limit: 50 });
+     *
+     * // Get next page
+     * if (cursor) {
+     *   const next = await kv.list({ prefix: 'user:', limit: 50, cursor });
+     * }
+     * ```
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for KVStore API
+    async list(options) {
+        const store = getKVStore();
+        return store.list(options);
+    },
+    /**
+     * Set a value in the KV store
+     *
+     * @param key - The key to set
+     * @param value - The value to store (string, object, or ArrayBuffer)
+     * @param options - Set options (ttl in seconds)
+     * @returns Promise that resolves when set is complete
+     *
+     * @example
+     * ```typescript
+     * // Set string
+     * await kv.set('name', 'John');
+     *
+     * // Set object (auto-JSON.stringify)
+     * await kv.set('user', { name: 'John', age: 30 });
+     *
+     * // Set with TTL (1 hour)
+     * await kv.set('session', { id: 'abc' }, { ttl: 3600 });
+     * ```
+     */
+    // biome-ignore lint/suspicious/useAwait: Wrapper for KVStore API
+    async set(key, value, options) {
+        const store = getKVStore();
+        return store.set(key, value, options);
+    },
+};
+/**
+ * Check if KV store is available in the current environment
+ *
+ * @returns true if ONREZA.kv is available
+ */
+export function isKVAvailable() {
+    return isOnrezaRuntime() && !!globalThis.ONREZA?.kv;
+}
+//# sourceMappingURL=kv.js.map

package/dist/kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.js","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO,OAAQ,UAAmC,CAAC,MAAM,KAAK,WAAW,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU;IACjB,MAAM,MAAM,GAAI,UAA4C,CAAC,MAAM,CAAC;IACpE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,oCAAoC;YAClC,4FAA4F,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB;;;;;OAKG;IACH,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD;;;;;;;;;;;;;;;OAeG;IACH,iEAAiE;IACjE,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,OAAsB;QAC3C,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAQ,KAAK,CAAC,GAAiE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChG,CAAC;IAED;;;;;OAKG;IACH,iEAAiE;IACjE,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,iEAAiE;IACjE,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iEAAiE;IACjE,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAoC,EAAE,OAAsB;QACjF,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACS,CAAC;AAEb;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,EAAE,IAAI,CAAC,CAAE,UAA4C,CAAC,MAAM,EAAE,EAAE,CAAC;AACzF,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@onreza/runtime",
+  "version": "0.2.0",
+  "description": "ONREZA runtime SDK - types and utilities for platform APIs",
+  "license": "MIT",
+  "author": "ONREZA OSS <opensource@onreza.ru>",
+  "type": "module",
+  "exports": {
+    "./kv": {
+      "types": "./dist/kv.d.ts",
+      "import": "./dist/kv.js"
+    },
+    "./db": {
+      "types": "./dist/db.d.ts",
+      "import": "./dist/db.js"
+    },
+    "./context": {
+      "types": "./dist/context.d.ts",
+      "import": "./dist/context.js"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "import": "./dist/image.js"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": "./dist/env.js"
+    },
+    "./types": {
+      "types": "./types.d.ts"
+    }
+  },
+  "files": ["dist", "types.d.ts"],
+  "keywords": ["onreza", "runtime", "edge", "kv", "d1", "image-optimization"],
+  "scripts": {
+    "build": "bun run build.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

package/types.d.ts

@@ -0,0 +1,222 @@
+/**
+ * ONREZA Runtime Global Types
+ *
+ * These types define the platform-injected global ONREZA object
+ * available in edge runtime (nrz-isolate).
+ *
+ * Usage in your code:
+ * ```typescript
+ * /// <reference types="@onreza/runtime/types" />
+ *
+ * // Or import specific modules:
+ * import { kv } from '@onreza/runtime/kv';
+ * import { db } from '@onreza/runtime/db';
+ * ```
+ */
+
+declare global {
+  /**
+   * ONREZA platform runtime API
+   * Injected by nrz-isolate at runtime
+   */
+  const ONREZA: OnrezaRuntime;
+}
+
+/**
+ * GeoIP data from edge server
+ */
+export interface OnrezaGeo {
+  /** ISO 3166-1 alpha-2 country code */
+  country: string | null;
+  /** City name */
+  city: string | null;
+  /** Continent code */
+  continent: string | null;
+  /** Edge region (e.g., "ru-central-1") */
+  region: string | null;
+}
+
+/**
+ * Platform context - readonly metadata about the current request
+ */
+export interface OnrezaContext {
+  /** Client IP address (forwarded from edge) */
+  readonly clientIp: string | null;
+  /** GeoIP data */
+  readonly geo: OnrezaGeo;
+  /** Current deployment ID */
+  readonly deploymentId: string | null;
+  /** Project ID */
+  readonly projectId: string | null;
+  /** Git commit SHA (short) */
+  readonly commitSha: string | null;
+  /** Unique request ID (UUID v7, generated per request) */
+  readonly requestId: string | null;
+}
+
+/**
+ * KV store operations result
+ */
+export interface KVListResult {
+  /** Keys in the result */
+  keys: string[];
+  /** Cursor for pagination (undefined if no more results) */
+  cursor?: string;
+}
+
+/**
+ * KV store options for set operations
+ */
+export interface KVSetOptions {
+  /** TTL in seconds (0 = no expiry) */
+  ttl?: number;
+}
+
+/**
+ * KV store get options
+ */
+export interface KVGetOptions {
+  /** Expected return type */
+  type?: "text" | "json" | "arrayBuffer";
+}
+
+/**
+ * KV store list options
+ */
+export interface KVListOptions {
+  /** Key prefix to filter */
+  prefix?: string;
+  /** Maximum number of keys to return (max 1000) */
+  limit?: number;
+  /** Cursor for pagination */
+  cursor?: string;
+}
+
+/**
+ * D1 database result metadata
+ */
+export interface D1Meta {
+  /** Execution time in seconds */
+  duration: number;
+  /** Rows changed (0 for SELECT) */
+  changes: number;
+  /** Last inserted rowid (0 for SELECT) */
+  last_row_id: number;
+  /** True if changes > 0 */
+  changed_db: boolean;
+  /** DB + WAL size in bytes */
+  size_after: number;
+  /** Result row count */
+  rows_read: number;
+  /** Same as changes (capped at 0) */
+  rows_written: number;
+  /** Always "nrz-isolate" */
+  served_by: string;
+  /** Always "local" (single-region) */
+  served_by_region: string;
+  /** Always true (no replicas) */
+  served_by_primary: boolean;
+  /** Timing details */
+  timings: {
+    /** SQL execution time in milliseconds */
+    sql_duration_ms: number;
+  };
+  /** Always 1 (no retries) */
+  total_attempts: number;
+}
+
+/**
+ * D1 query result
+ */
+export interface D1Result<T = unknown> {
+  /** Query results */
+  results: T[];
+  /** Whether query succeeded */
+  success: boolean;
+  /** Result metadata */
+  meta: D1Meta;
+}
+
+/**
+ * D1 prepared statement
+ */
+export interface D1PreparedStatement {
+  /** Bind parameters and return statement */
+  bind(...values: unknown[]): D1PreparedStatement;
+  /** Execute and return all rows */
+  all<T = unknown>(): Promise<D1Result<T>>;
+  /** Execute and return first row or null */
+  first<T = unknown>(colName?: string): Promise<T | null>;
+  /** Execute write operation */
+  run(): Promise<D1Result>;
+  /** Return raw array of arrays */
+  raw<T = unknown[]>(): Promise<T[]>;
+  raw<T = unknown[]>(options: { columnNames: true }): Promise<{ columns: string[]; results: T[] }>;
+}
+
+/**
+ * D1 database API
+ * Compatible with Cloudflare D1
+ */
+export interface D1Database {
+  /** Prepare a statement */
+  prepare(query: string): D1PreparedStatement;
+  /** Execute multiple statements (DDL) */
+  exec(query: string): Promise<{ count: number; duration: number }>;
+  /** Batch execute statements atomically */
+  batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
+  /** Dump database (not implemented - throws Error) */
+  dump(): Promise<ArrayBuffer>;
+  /** With session (not implemented - throws Error) */
+  withSession<T>(callback: (db: D1Database) => T | Promise<T>): Promise<T>;
+}
+
+/**
+ * KV store API
+ * Namespace-isolated by project_id
+ */
+export interface KVStore {
+  /** Get value by key */
+  get(key: string, options?: { type: "text" }): Promise<string | null>;
+  get<T = unknown>(key: string, options: { type: "json" }): Promise<T | null>;
+  get(key: string, options: { type: "arrayBuffer" }): Promise<ArrayBuffer | null>;
+  get(key: string): Promise<string | null>;
+
+  /** Set value */
+  set(key: string, value: string | object | ArrayBuffer, options?: KVSetOptions): Promise<void>;
+
+  /** Delete key */
+  delete(key: string): Promise<boolean>;
+
+  /** Check if key exists */
+  has(key: string): Promise<boolean>;
+
+  /** List keys with optional prefix */
+  list(options?: KVListOptions): Promise<KVListResult>;
+}
+
+/**
+ * Environment variable access
+ */
+export interface EnvStore {
+  /** Get environment variable */
+  get(key: string): string | undefined;
+  /** Check if environment variable exists */
+  has(key: string): boolean;
+  /** Iterate over all environment variables */
+  entries(): IterableIterator<[string, string]>;
+}
+
+/**
+ * Main ONREZA runtime interface
+ */
+export interface OnrezaRuntime {
+  /** KV store (requires bindings.kv: true in manifest) */
+  readonly kv: KVStore;
+  /** D1 database (requires bindings.db: true in manifest) */
+  readonly db: D1Database;
+  /** Platform context (request metadata) */
+  readonly context: OnrezaContext;
+  /** Environment variables */
+  readonly env: EnvStore;
+}