dev.edgebase.core 0.2.2

<p align="center"> <a href="https://github.com/edge-base/edgebase"> <img src="https://raw.githubusercontent.com/edge-base/edgebase/main/docs/static/img/logo-icon.svg" alt="EdgeBase Logo" width="72" /> </a> </p>

EdgeBase.Core

Low-level .NET primitives for EdgeBase.

EdgeBase.Core is the shared foundation used by EdgeBase.Admin and EdgeBase.Unity. It gives you the transport, table/query, storage, push, and field-operation building blocks without the higher-level package surface.

Most application code should install one of the higher-level packages instead:

• EdgeBase.Admin for trusted server-side code
• EdgeBase.Unity for Unity client apps

EdgeBase is the open-source edge-native BaaS that runs on Edge, Docker, and Node.js.

This package is one part of the wider EdgeBase platform. For the full platform, CLI, Admin Dashboard, server runtime, docs, and all public SDKs, see the main repository: edge-base/edgebase.

Documentation Map

Use this README for the fast overview, then jump into the docs when you need depth:

• SDK Overview Install commands and the full package matrix
• Client SDK Query patterns and low-level database usage from client-facing SDKs
• Admin SDK Trusted server-side database access and raw SQL
• Storage Docs Uploads, downloads, metadata, and signed URLs
• Push Client SDK Client-side push registration patterns and payload handling

For AI Coding Assistants

This package includes an llms.txt file for AI-assisted development.

You can find it:

• in this repository: llms.txt
• in the packed NuGet artifact alongside the package contents

Use it when you want an agent or code assistant to:

• keep low-level code inside the core package
• use JbHttpClient as the shared transport
• prefer TableRef, StorageClient, and FieldOps over made-up wrappers
• avoid copying JavaScript or Dart SDK shapes into C#

Installation

If you are working inside this repository, reference the project directly:

<ItemGroup>
  <ProjectReference Include="..\packages\sdk\csharp\packages\core\EdgeBase.Core.csproj" />
</ItemGroup>

The NuGet package id declared by the project is dev.edgebase.core.

Quick Start

using EdgeBase;
using EdgeBase.Generated;

var http = new JbHttpClient("https://your-project.edgebase.fun");

var storage = new StorageClient(http);
var bucket = storage.Bucket("avatars");
var publicUrl = bucket.GetUrl("user-1.jpg");

var api = new GeneratedDbApi(http);
var posts = new TableRef(api, "posts");
var result = await posts.Where("published", "==", true).GetListAsync();

var patch = FieldOps.Increment(1);
Console.WriteLine(publicUrl);
Console.WriteLine(result.Total);

Included Surfaces

• JbHttpClient
• TableRef, ListResult, and DbChange
• StorageClient, StorageBucket, FileListResult, and SignedUrlResult
• PushClient
• FieldOps
• EdgeBaseException
• GeneratedDbApi

Building On Top Of Core

This package is useful when you want to:

• write custom wrappers on top of the EdgeBase transport
• reuse the shared storage and table primitives in your own SDKs
• keep generated code separate from higher-level app entry points
• work with low-level helpers in trusted server or client code

Choose The Right Package

License

MIT