Lambros Petrou

This commit **updates the Durable Objects documentation** to clarify a critical limitation regarding **SQLite storage**. Specifically, it informs users that the `PRAGMA user_version` command is **not supported** within Durable Objects, preventing potential issues for developers. The **documentation update** in `rules-of-durable-objects.mdx` also provides alternative **schema migration strategies** and an updated code example, guiding users toward correct best practices for managing database schemas.

This commit **enhances the D1 documentation** by providing comprehensive details regarding various database operational limits. It specifically updates the `src/content/partials/d1/faq-limits.mdx` file to include in-depth information on storage, concurrency, throughput, query performance, CPU, and memory constraints. This **documentation update** clarifies the boundaries for D1 usage, enabling developers to better understand and optimize their applications against the platform's capabilities. The work is a **maintenance** effort to improve user understanding and resource planning for D1 databases.

Merge pull request #5009 from cloudflare/lambros/d1-add-total_attempts-meta

This change introduces a new `total_attempts` field to the D1 API's query meta response, affecting all clients consuming this API. It represents a new capability, requiring updates to type definitions and potentially client-side parsing logic.

This commit provides a **documentation update** to the **Durable Objects** section, specifically clarifying the **lifecycle** and **pricing** models. It refines the explanation in `src/content/docs/durable-objects/concepts/durable-object-lifecycle.mdx` to detail when an object is considered active, idle, and the specific conditions for hibernation. Concurrently, the `src/content/partials/durable-objects/do-faq-pricing.mdx` file is updated to simplify pricing explanations and direct users to the main lifecycle document for comprehensive details. This work aims to improve user understanding of Durable Object state transitions and their billing implications, reducing potential confusion.

This commit **improves the D1 documentation** by adding crucial clarifications regarding **one-way type conversions** within the D1 Worker API. Specifically, it details how D1 handles various data types during reads, provides insights into `STRICT` tables, and explains the behavior of `ArrayBuffer` views in `src/content/docs/d1/worker-api/index.mdx`. This **documentation enhancement** aims to prevent user confusion and improve the developer experience when interacting with the **Cloudflare D1 database**, addressing common misunderstandings about data type handling.

Merge pull request #3748 from cloudflare/lambros/extend-d1-meta-types

This commit performs a **maintenance update** to the **generated type snapshots** for the D1 service, specifically enhancing the `D1Meta` interface. It **adds new properties** including `served_by_region`, `served_by_primary`, and `timings` to provide richer metadata about D1 query execution. This ensures that consumers of these type definitions, particularly those interacting with **Cloudflare D1**, have accurate and complete type information for operational details. The update is applied across various dated snapshots, as well as `experimental` and `oldest` versions, to maintain consistency and **type safety** for these new fields.

Extend D1 meta information - served_by_region/served_by_primary and sql_duration_ms

Merge pull request #3726 from cloudflare/lambros/fix-d1-binding-class-name

This commit **fixes a bug** by reverting the rename of the **D1 binding class** within `src/cloudflare/internal/d1-api.ts`. The previous renaming caused issues with the **Vitest test suite**, leading to failures in the **Cloudflare D1 integration's** tests. By restoring the original class name, this change ensures the test suite for the D1 binding functions correctly, maintaining the stability of the testing environment.

Merge pull request #3701 from cloudflare/lambros/cfsql-1221-extend-d1-types-with-sessions-api

This commit **updates the automatically generated type definitions** located in the `types/generated-snapshots` directory. This **maintenance** task ensures that the project's type information accurately reflects the latest schema or API contract changes, thereby enhancing **type safety** and preventing potential runtime issues. It provides developers with up-to-date interfaces for improved autocompletion and compile-time checks across modules consuming these types. The update is crucial for maintaining consistency between the codebase and its external data structures.

This commit primarily **refines the type signature** of the `withSession()` method within the **Cloudflare D1 API**, removing `null` as a permissible type for its `constraintOrBookmark` parameter. This **type fix** enhances the strictness and correctness of session management inputs, preventing invalid `null` values from being passed. To ensure this, a **type assertion** was added to the D1 type tests, verifying the method's return type when invoked without arguments. Additionally, related test comments were updated for consistency, solidifying the improved type safety for developers interacting with D1 sessions.

Merge pull request #3700 from cloudflare/lambros/cfsql-1220-d1-sessions-api-default

This commit provides a **maintenance fix** by resolving an **ESLint issue** within the **Cloudflare D1 API internal utility**. Specifically, it removes an unnecessary `@deprecated` JSDoc tag from `src/cloudflare/internal/d1-api.ts` that was causing a linting error. This change improves code quality and ensures compliance with project linting rules without altering any functional behavior of the D1 API.

This commit performs a **maintenance update** of the **generated snapshot files** within the `types` module. It regenerates the `types/generated-snapshot` directory by executing the `bazel build //types:types` command and copying the resulting definitions. This ensures that the committed snapshot accurately reflects the current state of the project's type definitions, maintaining consistency for downstream builds and consumers of these types.

This commit **introduces TypeScript type definitions** for the new **D1 Sessions API**, a **new feature** designed to support read replication with D1 databases. It updates the `withSession` method signature within the **D1 binding types** in `src/cloudflare/internal/d1-api.ts` and adds deprecation comments to `dump` methods. Comprehensive test cases for `withSession`, `getBookmark`, `prepare`, and `batch` methods are also included in `types/test/types/d1.ts` to validate the new API surface. This enhancement allows developers to utilize the D1 Sessions API with full type safety, facilitating advanced D1 database interactions.

This commit **enables the D1 Sessions API by default for all users**, eliminating the need for a specific compatibility flag. The `makeBinding` function within `src/cloudflare/internal/d1-api.ts` was modified to unconditionally return `D1DatabaseWithSessionAPI`, ensuring the feature is always active. As a result, the `enableD1WithSessionsAPI` compatibility flag has been **deprecated and renamed to `obsolete61`** in `src/workerd/io/compatibility-date.capnp`, with corresponding updates to comments and test configurations. This change simplifies the developer experience by making the **D1 Sessions API universally accessible** without requiring explicit enablement.

Merge pull request #3506 from cloudflare/lambros/extend-d1result-meta