ramosedb 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Tyler van Hensbergen
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,17 @@
+Ramose
+Copyright 2026 Tyler van Hensbergen
+
+This product includes software developed at
+https://github.com/tvanhens/ramose
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# ramose
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An immutable, Datomic-inspired graph database for Cloudflare (Workers +
+Durable Objects + R2), built on Effect. Your data model is one TypeScript
+value; queries and authoritative operations are portable values too.
+
+```sh
+bun add ramosedb effect@rc
+```
+
+`npm install` and `pnpm add` work the same. `effect` is a required peer:
+operation input and output codecs are Effect Schemas, and declaring the peer
+keeps strict dependency resolvers on one compatible Effect instance. Alchemy
+comes with RamoseDB. Apps using `ramosedb/better-auth` also need the optional
+peers `better-auth` and `zod`.
+
+RamoseDB is pre-release: expect the API to change between minor versions.
+
+## The public entries
+
+| Import | What it is |
+| --- | --- |
+| `ramosedb/db` | Portable schemas, fields, queries, owned operation types, and tagged errors. |
+| `ramosedb/client` | The offline-first browser client: `createClient`, interned database handles, local query execution over a durable authorized replica, and framework-neutral subscriptions. |
+| `ramosedb/react` | React hooks for queries, operation receipts, synchronization state, and Suspense. |
+| `ramosedb` | Deployment resources: `Server`, `Database`, JWT claims, providers, and HTTP error mapping. |
+| `ramosedb/worker` | The peer Worker itself. Hand it to Alchemy as `main: import.meta.resolve("ramosedb/worker")` — `main` is a path, so a bare specifier there silently resolves to nothing. |
+| `ramosedb/better-auth/client` | Browser credential provider with bearer caching, renewal, offline fallback, and sign-out cleanup. |
+| `ramosedb/better-auth` | The Better Auth plugin that mints the identity JWT a peer verifies. Needs optional peers `better-auth` and `zod`. |
+
+App schemas use `Ramose.string()` / `boolean()` / `enumeration([...])`. Declare operations inside an entity or trait’s `operations` callback. Operation
+codecs import `effect/Schema` from the application's declared Effect peer.
+
+## A first look
+
+```ts
+// schema.ts
+import * as Ramose from "ramosedb/db";
+
+export const Todo = Ramose.Entity("todo", {
+  title: Ramose.string(),
+  done: Ramose.boolean(),
+});
+
+export const Todos = Ramose.Schema("todos", { todo: Todo });
+
+Todos.applyPolicy(({ policy }) => {
+  policy.todo.read.always();
+});
+```
+
+## Docs
+
+Full documentation lives at **[ramose.ai](https://ramose.ai)**.
+
+## License
+
+Apache-2.0 — see [LICENSE](./LICENSE) and [NOTICE](./NOTICE).

package/dist/Auth.d.ts

@@ -0,0 +1,55 @@
+export interface Claims {
+    readonly iss?: string;
+    readonly aud?: string | readonly string[];
+    readonly sub?: string;
+    readonly iat?: number;
+    readonly exp?: number;
+    readonly ramose?: {
+        readonly db?: string;
+        readonly class?: string;
+        readonly attrs?: Readonly<Record<string, unknown>>;
+    };
+    readonly [claim: string]: unknown;
+}
+/** Cap on a token's lifetime when `RAMOSE_JWT_MAX_TTL` is unset, in seconds. */
+export declare const DEFAULT_JWT_MAX_TTL = 900;
+export interface AuthConfig {
+    readonly issuer: string;
+    readonly audience: string;
+    readonly ttl: number;
+}
+/** The subject-and-class half of a claim set; {@link AuthConfig} is the rest. */
+export interface ClaimsInput {
+    readonly sub: string;
+    readonly class: string;
+    readonly attrs?: Readonly<Record<string, unknown>> | undefined;
+    readonly now?: Date | undefined;
+}
+/** Declared class vocabulary used to reject undeclared mint classes. */
+export type ClaimsPolicy = {
+    readonly classes: readonly string[];
+};
+/**
+ * Build the claim set the peer verifies. Pure: no signing, no I/O.
+ *
+ * Validates at mint what the peer would reject anyway: when a compiled
+ * policy is given, `class` must be one the policy declares, because an
+ * undeclared class grants nothing, never an outage. `exp - iat` is exactly
+ * `auth.ttl`. JWT identity is deployment-global — do not emit `ramose.db`.
+ *
+ * @example
+ * ```typescript
+ * const payload = Ramose.claims(
+ *   AUTH,
+ *   { sub: user.id, class: role },
+ *   { classes: ["member"] },
+ * );
+ * const { token } = await auth.api.signJWT({ body: { payload } });
+ * ```
+ */
+export declare function claims<P extends ClaimsPolicy | undefined = undefined>(auth: AuthConfig, input: [P] extends [string | undefined] ? ClaimsInput : P extends {
+    readonly classes: infer CL extends readonly string[];
+} ? Omit<ClaimsInput, "class"> & {
+    readonly class: CL[number];
+} : ClaimsInput, policy?: P): Claims;
+//# sourceMappingURL=Auth.d.ts.map

package/dist/Auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../src/Auth.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACpD,CAAC;IACF,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACjC;AAED,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAKnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACnE,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,GACnC,WAAW,GACX,CAAC,SAAS;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,CAAA;CAAE,GAChE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;CAAE,GAC3D,WAAW,EACjB,MAAM,CAAC,EAAE,CAAC,GACT,MAAM,CA0BR"}

package/dist/Auth.js

@@ -0,0 +1,50 @@
+import { InvalidRequest } from "./db/Errors.js";
+/** Cap on a token's lifetime when `RAMOSE_JWT_MAX_TTL` is unset, in seconds. */
+export const DEFAULT_JWT_MAX_TTL = 900;
+const declaredClasses = (policy) => policy.classes.filter((c) => typeof c === "string");
+/**
+ * Build the claim set the peer verifies. Pure: no signing, no I/O.
+ *
+ * Validates at mint what the peer would reject anyway: when a compiled
+ * policy is given, `class` must be one the policy declares, because an
+ * undeclared class grants nothing, never an outage. `exp - iat` is exactly
+ * `auth.ttl`. JWT identity is deployment-global — do not emit `ramose.db`.
+ *
+ * @example
+ * ```typescript
+ * const payload = Ramose.claims(
+ *   AUTH,
+ *   { sub: user.id, class: role },
+ *   { classes: ["member"] },
+ * );
+ * const { token } = await auth.api.signJWT({ body: { payload } });
+ * ```
+ */
+export function claims(auth, input, policy) {
+    if (!Number.isInteger(auth.ttl) || auth.ttl <= 0) {
+        throw new InvalidRequest({
+            message: `ramose: auth.ttl must be a positive whole number of seconds, got ${auth.ttl}`,
+        });
+    }
+    if (policy !== undefined) {
+        const classes = declaredClasses(policy);
+        if (!classes.includes(input.class)) {
+            throw new InvalidRequest({
+                message: `ramose: class ${JSON.stringify(input.class)} is not declared by the policy (classes: ${classes.join(", ")}) — an undeclared class grants nothing, so fail at mint`,
+            });
+        }
+    }
+    const iat = Math.floor((input.now ?? new Date()).getTime() / 1000);
+    return {
+        iss: auth.issuer,
+        aud: auth.audience,
+        sub: input.sub,
+        iat,
+        exp: iat + auth.ttl,
+        ramose: {
+            class: input.class,
+            ...(input.attrs === undefined ? {} : { attrs: input.attrs }),
+        },
+    };
+}
+//# sourceMappingURL=Auth.js.map

package/dist/Auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.js","sourceRoot":"","sources":["../src/Auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAehD,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAmBvC,MAAM,eAAe,GAAG,CAAC,MAAoB,EAAqB,EAAE,CAClE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM,CACpB,IAAgB,EAChB,KAIiB,EACjB,MAAU;IAEV,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,cAAc,CAAC;YACvB,OAAO,EAAE,oEAAoE,IAAI,CAAC,GAAG,EAAE;SACxF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,cAAc,CAAC;gBACvB,OAAO,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,4CAA4C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yDAAyD;aAC7K,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,MAAM;QAChB,GAAG,EAAE,IAAI,CAAC,QAAQ;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG;QACH,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG;QACnB,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;SAC7D;KACF,CAAC;AACJ,CAAC"}

package/dist/Database.d.ts

@@ -0,0 +1,40 @@
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import type { Schema } from "./db/index.ts";
+import { InvalidRequest } from "./db/Errors.ts";
+import type { Providers } from "./Providers.ts";
+import type { Server } from "./Server.ts";
+export declare const isDatabase: (value: unknown) => value is Database;
+export type DatabaseProps = {
+    server: Server;
+    schema: Schema.Any;
+    name?: string;
+    timeoutMs?: number;
+};
+export declare const DEFAULT_INSTALL_TIMEOUT_MS = 60000;
+export type Database = Resource<"Ramose.Database", DatabaseProps, {
+    name: string;
+    server: string;
+    t: number;
+}, never, Providers>;
+declare const DatabaseResource: import("alchemy").ResourceClass<Database>;
+/**
+ * Declare a database name and install its catalog.
+ *
+ * `server` may be given as the `Ramose.Server(…)` *declaration* — a yieldable
+ * Effect, not a resource instance — exactly as `Server` takes a
+ * `Cloudflare.Worker` declaration: `yield*`ing it here is what makes the
+ * engine order the install after the server and substitute the real URL at
+ * reconcile.
+ */
+export declare const Database: typeof DatabaseResource;
+export declare const installCatalog: (args: {
+    readonly name: string;
+    readonly url: string;
+    readonly schema: Schema.Any;
+    readonly timeoutMs?: number | undefined;
+}) => Effect.Effect<never, InvalidRequest, never>;
+export declare const DatabaseProvider: () => import("effect/Layer").Layer<Provider.Provider<Database>, never, never>;
+export {};
+//# sourceMappingURL=Database.d.ts.map

package/dist/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../src/Database.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAoB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,KAAK,IAAI,QACT,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAC7B,iBAAiB,EACjB,aAAa,EACb;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;CACX,EACD,KAAK,EACL,SAAS,CACV,CAAC;AAEF,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAehB,OAAO,gBAAgB,CAAC;AAa7B,eAAO,MAAM,cAAc;mBACV,MAAM;kBACP,MAAM;qBACH,MAAM,CAAC,GAAG;yBACN,MAAM,GAAG,SAAS;iDAWvC,CAAC;AAcH,eAAO,MAAM,gBAAgB,+EAUzB,CAAC"}

package/dist/Database.js

@@ -0,0 +1,62 @@
+import * as Provider from "alchemy/Provider";
+import { isResourceOfType, Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import { InvalidRequest } from "./db/Errors.js";
+export const isDatabase = (value) => isResourceOfType(value, "Ramose.Database");
+export const DEFAULT_INSTALL_TIMEOUT_MS = 60_000;
+const DatabaseResource = Resource("Ramose.Database");
+/**
+ * Declare a database name and install its catalog.
+ *
+ * `server` may be given as the `Ramose.Server(…)` *declaration* — a yieldable
+ * Effect, not a resource instance — exactly as `Server` takes a
+ * `Cloudflare.Worker` declaration: `yield*`ing it here is what makes the
+ * engine order the install after the server and substitute the real URL at
+ * reconcile.
+ */
+export const Database = Object.assign((id, props) => DatabaseResource(id, Effect.gen(function* () {
+    const server = props.server;
+    return {
+        ...props,
+        server: Effect.isEffect(server) ? yield* server : server,
+    };
+})), DatabaseResource);
+const resolveServer = (server) => {
+    const resolved = server;
+    return {
+        url: resolved?.url,
+    };
+};
+export const installCatalog = Effect.fn(function* (args) {
+    const { name, url } = args;
+    if (url === undefined || url === "") {
+        return yield* new InvalidRequest({
+            message: `ramose: the server for database ${JSON.stringify(name)} has no URL — deploy it before installing a schema on it`,
+        });
+    }
+    return yield* new InvalidRequest({
+        message: `ramose: catalog install on ${JSON.stringify(name)} is closed until authorized catalog publication is wired`,
+    });
+});
+const install = Effect.fn(function* (id, props) {
+    const name = props.name ?? id;
+    const { url } = resolveServer(props.server);
+    return yield* installCatalog({
+        name,
+        url: url ?? "",
+        schema: props.schema,
+        timeoutMs: props.timeoutMs,
+    });
+});
+// @effect-diagnostics-next-line lazyEffect:off
+export const DatabaseProvider = () => Provider.succeed(Database, {
+    reconcile: Effect.fn(function* ({ id, news }) {
+        return yield* install(id, news);
+    }),
+    read: Effect.fn(function* ({ output }) {
+        return output ?? undefined;
+    }),
+    delete: Effect.fn(function* () {
+    }),
+});
+//# sourceMappingURL=Database.js.map

package/dist/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sourceRoot":"","sources":["../src/Database.ts"],"names":[],"mappings":"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"}

package/dist/Providers.d.ts

@@ -0,0 +1,8 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Ramose">;
+export declare class Providers extends Providers_base {
+}
+export declare const providers: () => Layer.Layer<Providers, never, import("alchemy").AlchemyContext>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/dist/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;;AAItC,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAGJ,eAAO,MAAM,SAAS,uEAInB,CAAC"}

package/dist/Providers.js

@@ -0,0 +1,9 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import { Database, DatabaseProvider } from "./Database.js";
+import { Server, ServerProvider } from "./Server.js";
+export class Providers extends Provider.ProviderCollection()("Ramose") {
+}
+// @effect-diagnostics-next-line lazyEffect:off
+export const providers = () => Layer.effect(Providers, Provider.collection([Server, Database])).pipe(Layer.provide(Layer.mergeAll(ServerProvider(), DatabaseProvider())), Layer.orDie);
+//# sourceMappingURL=Providers.js.map

package/dist/Providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CACrE,QAAQ,CACT;CAAG;AAEJ,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACnE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,EACnE,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/dist/RamoseEnv.d.ts

@@ -0,0 +1,37 @@
+import type { AnalyticsEngineDatasetLike } from "./internal/transactor/observability.ts";
+export interface RamoseEnv {
+    STORE: R2Bucket;
+    TRANSACTOR: DurableObjectNamespace;
+    REPLICA: DurableObjectNamespace;
+    CF_VERSION_METADATA?: {
+        readonly id: string;
+        readonly tag: string;
+        readonly timestamp: string;
+    };
+    ANALYTICS?: AnalyticsEngineDatasetLike;
+    RAMOSE_STAGE?: string;
+    RAMOSE_JWKS_URL?: string;
+    RAMOSE_JWKS_SERVICE?: string;
+    RAMOSE_JWKS_JSON?: string;
+    RAMOSE_JWT_ISS?: string;
+    RAMOSE_JWT_AUD?: string;
+    RAMOSE_JWT_MAX_TTL?: string;
+    RAMOSE_ALLOWED_ORIGINS?: string;
+    RAMOSE_INTERNAL_SECRET: string;
+    RAMOSE_INDEX_INTERVAL_MS?: string;
+    RAMOSE_INDEX_TX_THRESHOLD?: string;
+    RAMOSE_INDEX_MAX_TXS_PER_RUN?: string;
+    RAMOSE_LOG_KEEP_TXS?: string;
+    RAMOSE_GC_EVERY_N_INDEXES?: string;
+    RAMOSE_RETAIN_ROOTS?: string;
+    RAMOSE_MAX_BATCH?: string;
+    RAMOSE_TIMING_YIELDS?: string;
+    RAMOSE_QUERY_MAX_CELLS?: string;
+    RAMOSE_LOG_LEVEL?: string;
+    RAMOSE_REPLICA_HINT?: string;
+    RAMOSE_CACHE_BASIS?: string;
+    RAMOSE_CACHE_MODE?: string;
+    RAMOSE_TEST_HOOKS?: string;
+    RAMOSE_TEST_CAPABILITY?: string;
+}
+//# sourceMappingURL=RamoseEnv.d.ts.map

package/dist/RamoseEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RamoseEnv.d.ts","sourceRoot":"","sources":["../src/RamoseEnv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAEzF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,EAAE,sBAAsB,CAAC;IAChC,mBAAmB,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC"}

package/dist/RamoseEnv.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RamoseEnv.js.map

package/dist/RamoseEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RamoseEnv.js","sourceRoot":"","sources":["../src/RamoseEnv.ts"],"names":[],"mappings":""}