@treeseed/sdk 0.1.1

package/dist/stores/subscription-store.js

@@ -0,0 +1,171 @@
+import { SqliteStoreBase, toSqlValue } from "./helpers.js";
+import { createSubscriptionEnvelope, subscriptionEntityFromEnvelope, TRESEED_ENVELOPE_SCHEMA_VERSION } from "./envelopes.js";
+function subscriptionFromRow(row) {
+  return {
+    id: row.id !== void 0 ? Number(row.id) : void 0,
+    email: String(row.email ?? ""),
+    name: row.name !== void 0 && row.name !== null ? String(row.name) : null,
+    status: String(row.status ?? "active"),
+    source: row.source !== void 0 && row.source !== null ? String(row.source) : void 0,
+    consent_at: row.consent_at !== void 0 && row.consent_at !== null ? String(row.consent_at) : void 0,
+    created_at: row.created_at !== void 0 && row.created_at !== null ? String(row.created_at) : void 0,
+    updated_at: row.updated_at !== void 0 && row.updated_at !== null ? String(row.updated_at) : void 0,
+    ip_hash: row.ip_hash !== void 0 && row.ip_hash !== null ? String(row.ip_hash) : void 0
+  };
+}
+function buildFilterSql(filters = []) {
+  return filters?.length ? `WHERE ${filters.map((filter) => {
+    switch (filter.op) {
+      case "eq":
+        return `${filter.field} = ${toSqlValue(filter.value)}`;
+      case "in":
+        return `${filter.field} IN (${(Array.isArray(filter.value) ? filter.value : [filter.value]).map(toSqlValue).join(", ")})`;
+      case "updated_since":
+        return `${filter.field} >= ${toSqlValue(filter.value)}`;
+      default:
+        return `${filter.field} LIKE ${toSqlValue(`%${String(filter.value ?? "")}%`)}`;
+    }
+  }).join(" AND ")}` : "";
+}
+class SubscriptionStore extends SqliteStoreBase {
+  async usesEnvelopeTable() {
+    return this.tableExists("runtime_records");
+  }
+  async getByKey(key) {
+    if (await this.usesEnvelopeTable()) {
+      const row2 = await this.selectFirst(
+        `SELECT * FROM runtime_records WHERE record_type = 'subscription' AND (record_key = ${toSqlValue(key)} OR lookup_key = ${toSqlValue(key)} OR id = ${toSqlValue(key)}) LIMIT 1`
+      );
+      if (row2) {
+        return subscriptionEntityFromEnvelope(row2);
+      }
+    }
+    const field = key.includes("@") ? "email" : "id";
+    const row = await this.selectFirst(`SELECT * FROM subscriptions WHERE ${field} = ${toSqlValue(key)} LIMIT 1`);
+    return row ? subscriptionFromRow(row) : null;
+  }
+  async search(request) {
+    if (await this.usesEnvelopeTable()) {
+      const sql2 = [
+        "SELECT * FROM runtime_records WHERE record_type = 'subscription'",
+        buildEnvelopeFilterSql(request.filters),
+        request.sort?.length ? `ORDER BY ${request.sort.map((entry) => `${subscriptionSortColumn(entry.field)} ${entry.direction === "asc" ? "ASC" : "DESC"}`).join(", ")}` : "ORDER BY updated_at DESC",
+        request.limit ? `LIMIT ${request.limit}` : ""
+      ].filter(Boolean).join(" ");
+      const rows2 = await this.selectAll(sql2);
+      return rows2.map(subscriptionEntityFromEnvelope);
+    }
+    const sql = [
+      "SELECT * FROM subscriptions",
+      buildFilterSql(request.filters),
+      request.sort?.length ? `ORDER BY ${request.sort.map((entry) => `${entry.field} ${entry.direction === "asc" ? "ASC" : "DESC"}`).join(", ")}` : "",
+      request.limit ? `LIMIT ${request.limit}` : ""
+    ].filter(Boolean).join(" ");
+    const rows = await this.selectAll(sql);
+    return rows.map(subscriptionFromRow);
+  }
+  async create(request) {
+    const data = request.data;
+    if (await this.usesEnvelopeTable()) {
+      const envelope = createSubscriptionEnvelope({
+        email: String(data.email ?? ""),
+        name: data.name !== void 0 && data.name !== null ? String(data.name) : null,
+        status: typeof data.status === "string" ? data.status : "active",
+        source: typeof data.source === "string" ? data.source : "sdk",
+        consentAt: typeof data.consent_at === "string" ? data.consent_at : (/* @__PURE__ */ new Date()).toISOString(),
+        ipHash: typeof data.ip_hash === "string" ? data.ip_hash : ""
+      });
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      await this.execute(
+        `INSERT INTO runtime_records (record_type, record_key, lookup_key, status, schema_version, created_at, updated_at, payload_json, meta_json) VALUES ('subscription', ${toSqlValue(envelope.payload.email)}, ${toSqlValue(envelope.payload.email)}, ${toSqlValue(envelope.status)}, ${TRESEED_ENVELOPE_SCHEMA_VERSION}, ${toSqlValue(now)}, ${toSqlValue(now)}, ${toSqlValue(JSON.stringify(envelope.payload))}, ${toSqlValue(JSON.stringify(envelope.meta))})`
+      );
+      return this.getByKey(envelope.payload.email);
+    }
+    await this.execute(
+      `INSERT INTO subscriptions (email, name, status, source, consent_at, created_at, updated_at, ip_hash) VALUES (${toSqlValue(data.email)}, ${toSqlValue(data.name ?? null)}, ${toSqlValue(data.status ?? "active")}, ${toSqlValue(data.source ?? "sdk")}, ${toSqlValue(data.consent_at ?? (/* @__PURE__ */ new Date()).toISOString())}, ${toSqlValue(data.created_at ?? (/* @__PURE__ */ new Date()).toISOString())}, ${toSqlValue(data.updated_at ?? (/* @__PURE__ */ new Date()).toISOString())}, ${toSqlValue(data.ip_hash ?? "")})`
+    );
+    return this.getByKey(String(data.email));
+  }
+  async update(request) {
+    const key = String(request.id ?? request.key ?? request.data.email ?? "");
+    const existing = await this.getByKey(key);
+    if (!existing) {
+      throw new Error(`No subscription found for "${key}".`);
+    }
+    const next = {
+      ...existing,
+      ...request.data,
+      updated_at: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    if (await this.usesEnvelopeTable()) {
+      const envelope = createSubscriptionEnvelope({
+        email: existing.email,
+        name: next.name ?? null,
+        status: String(next.status ?? "active"),
+        source: typeof next.source === "string" ? next.source : "sdk",
+        consentAt: typeof next.consent_at === "string" ? next.consent_at : null,
+        ipHash: typeof next.ip_hash === "string" ? next.ip_hash : "",
+        meta: { legacyId: existing.id }
+      });
+      await this.execute(
+        `UPDATE runtime_records SET status = ${toSqlValue(envelope.status)}, updated_at = ${toSqlValue(String(next.updated_at))}, payload_json = ${toSqlValue(JSON.stringify(envelope.payload))}, meta_json = ${toSqlValue(JSON.stringify(envelope.meta))} WHERE record_type = 'subscription' AND record_key = ${toSqlValue(existing.email)}`
+      );
+      return this.getByKey(existing.email);
+    }
+    await this.execute(
+      `UPDATE subscriptions SET name = ${toSqlValue(next.name ?? null)}, status = ${toSqlValue(next.status)}, source = ${toSqlValue(next.source ?? "sdk")}, consent_at = ${toSqlValue(next.consent_at ?? null)}, updated_at = ${toSqlValue(next.updated_at ?? (/* @__PURE__ */ new Date()).toISOString())}, ip_hash = ${toSqlValue(next.ip_hash ?? "")} WHERE email = ${toSqlValue(existing.email)}`
+    );
+    return this.getByKey(existing.email);
+  }
+}
+function buildEnvelopeFilterSql(filters = []) {
+  if (!filters?.length) return "";
+  const clauses = filters.map((filter) => {
+    const field = subscriptionFilterColumn(filter.field);
+    switch (filter.op) {
+      case "eq":
+        return `${field} = ${toSqlValue(filter.value)}`;
+      case "in":
+        return `${field} IN (${(Array.isArray(filter.value) ? filter.value : [filter.value]).map(toSqlValue).join(", ")})`;
+      case "updated_since":
+        return `updated_at >= ${toSqlValue(filter.value)}`;
+      default:
+        return `${field} LIKE ${toSqlValue(`%${String(filter.value ?? "")}%`)}`;
+    }
+  });
+  return clauses.length > 0 ? `AND ${clauses.join(" AND ")}` : "";
+}
+function subscriptionFilterColumn(field) {
+  switch (field) {
+    case "email":
+      return "lookup_key";
+    case "status":
+      return "status";
+    case "updated_at":
+    case "updatedAt":
+      return "updated_at";
+    case "created_at":
+    case "createdAt":
+      return "created_at";
+    default:
+      return `json_extract(payload_json, '$.${field}')`;
+  }
+}
+function subscriptionSortColumn(field) {
+  switch (field) {
+    case "email":
+      return "lookup_key";
+    case "status":
+      return "status";
+    case "created_at":
+    case "createdAt":
+      return "created_at";
+    case "updated_at":
+    case "updatedAt":
+    default:
+      return "updated_at";
+  }
+}
+export {
+  SubscriptionStore
+};

package/dist/test/test-fixture.d.ts

@@ -0,0 +1 @@
+export declare const sdkFixtureRoot: string;

package/dist/test/utils/envelopes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/utils/sdk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/agents.js

@@ -0,0 +1,40 @@
+const AGENT_TRIGGER_KINDS = ["schedule", "message", "follow", "startup"];
+const AGENT_PERMISSION_OPERATIONS = [
+  "get",
+  "read",
+  "search",
+  "follow",
+  "pick",
+  "create",
+  "update"
+];
+const AGENT_MESSAGE_STATUSES = [
+  "pending",
+  "claimed",
+  "completed",
+  "failed",
+  "dead_letter"
+];
+const AGENT_RUN_STATUSES = ["running", "completed", "failed", "waiting"];
+const AGENT_HANDLER_KINDS = [
+  "planner",
+  "architect",
+  "engineer",
+  "notifier",
+  "researcher",
+  "reviewer",
+  "releaser"
+];
+const AGENT_CLI_ALLOW_TOOLS = [
+  "shell(git)",
+  "shell(npm)",
+  "web"
+];
+export {
+  AGENT_CLI_ALLOW_TOOLS,
+  AGENT_HANDLER_KINDS,
+  AGENT_MESSAGE_STATUSES,
+  AGENT_PERMISSION_OPERATIONS,
+  AGENT_RUN_STATUSES,
+  AGENT_TRIGGER_KINDS
+};

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/wrangler-d1.js

@@ -0,0 +1,84 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+function toSqlValue(value) {
+  if (value === null || value === void 0) {
+    return "NULL";
+  }
+  if (typeof value === "number") {
+    return String(value);
+  }
+  if (typeof value === "boolean") {
+    return value ? "1" : "0";
+  }
+  return `'${String(value).replace(/'/g, "''")}'`;
+}
+function interpolateBindings(query, values) {
+  let result = query;
+  for (const value of values) {
+    result = result.replace(/\?/, toSqlValue(value));
+  }
+  return result;
+}
+class WranglerD1PreparedStatement {
+  constructor(databaseName, cwd, persistTo, query = "") {
+    this.databaseName = databaseName;
+    this.cwd = cwd;
+    this.persistTo = persistTo;
+    this.query = query;
+  }
+  databaseName;
+  cwd;
+  persistTo;
+  query;
+  bindings = [];
+  bind(...values) {
+    this.bindings = values;
+    return this;
+  }
+  async execute() {
+    const args = ["d1", "execute", this.databaseName, "--json", "--command", interpolateBindings(this.query, this.bindings)];
+    if (this.persistTo) {
+      args.splice(3, 0, "--local", "--persist-to", this.persistTo);
+    }
+    const { stdout } = await execFileAsync("wrangler", args, {
+      cwd: this.cwd,
+      env: process.env
+    });
+    const parsed = JSON.parse(stdout);
+    return Array.isArray(parsed) ? parsed : [parsed];
+  }
+  async run() {
+    return this.execute();
+  }
+  async all() {
+    const results = await this.execute();
+    return {
+      results: results.flatMap((entry) => entry.results ?? [])
+    };
+  }
+  async first() {
+    const { results } = await this.all();
+    return results[0] ?? null;
+  }
+  async raw() {
+    const { results } = await this.all();
+    return results.map((entry) => Object.values(entry));
+  }
+}
+class WranglerD1Database {
+  constructor(databaseName, cwd, persistTo) {
+    this.databaseName = databaseName;
+    this.cwd = cwd;
+    this.persistTo = persistTo;
+  }
+  databaseName;
+  cwd;
+  persistTo;
+  prepare(query) {
+    return new WranglerD1PreparedStatement(this.databaseName, this.cwd, this.persistTo, query);
+  }
+}
+export {
+  WranglerD1Database
+};

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@treeseed/sdk",
+  "version": "0.1.1",
+  "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treeseed-ai/sdk.git",
+    "directory": "."
+  },
+  "homepage": "https://treeseed.ai",
+  "bugs": {
+    "url": "https://github.com/treeseed-ai/sdk/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "setup": "npm install",
+    "setup:ci": "npm ci",
+    "build": "npm run build:dist",
+    "build:dist": "node ./scripts/run-ts.mjs ./scripts/build-dist.ts",
+    "prepare": "npm run build:dist",
+    "prepack": "npm run build:dist",
+    "test": "npm run test:unit",
+    "test:unit": "vitest run --config ./vitest.config.ts",
+    "test:smoke": "node ./scripts/run-ts.mjs ./scripts/test-smoke.ts",
+    "verify": "npm run release:verify",
+    "release:setup": "npm run setup:ci",
+    "release:check-tag": "node ./scripts/run-ts.mjs ./scripts/assert-release-tag-version.ts",
+    "release:verify": "node ./scripts/run-ts.mjs ./scripts/release-verify.ts",
+    "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
+  },
+  "dependencies": {
+    "esbuild": "^0.28.0",
+    "typescript": "^5.9.3",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "vitest": "^4.1.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk.d.ts",
+      "default": "./dist/sdk.js"
+    },
+    "./content-store": {
+      "types": "./dist/content-store.d.ts",
+      "default": "./dist/content-store.js"
+    },
+    "./d1-store": {
+      "types": "./dist/d1-store.d.ts",
+      "default": "./dist/d1-store.js"
+    },
+    "./frontmatter": {
+      "types": "./dist/frontmatter.d.ts",
+      "default": "./dist/frontmatter.js"
+    },
+    "./git-runtime": {
+      "types": "./dist/git-runtime.d.ts",
+      "default": "./dist/git-runtime.js"
+    },
+    "./models": {
+      "types": "./dist/model-registry.d.ts",
+      "default": "./dist/model-registry.js"
+    },
+    "./sdk-filters": {
+      "types": "./dist/sdk-filters.d.ts",
+      "default": "./dist/sdk-filters.js"
+    },
+    "./cli-tools": {
+      "types": "./dist/cli-tools.d.ts",
+      "default": "./dist/cli-tools.js"
+    },
+    "./types": {
+      "types": "./dist/sdk-types.d.ts",
+      "default": "./dist/sdk-types.js"
+    },
+    "./types/agents": {
+      "types": "./dist/types/agents.d.ts",
+      "default": "./dist/types/agents.js"
+    },
+    "./types/cloudflare": {
+      "types": "./dist/types/cloudflare.d.ts",
+      "default": "./dist/types/cloudflare.js"
+    },
+    "./wrangler-d1": {
+      "types": "./dist/wrangler-d1.d.ts",
+      "default": "./dist/wrangler-d1.js"
+    },
+    "./stores/cursor-store": {
+      "types": "./dist/stores/cursor-store.d.ts",
+      "default": "./dist/stores/cursor-store.js"
+    },
+    "./stores/helpers": {
+      "types": "./dist/stores/helpers.d.ts",
+      "default": "./dist/stores/helpers.js"
+    },
+    "./stores/lease-store": {
+      "types": "./dist/stores/lease-store.d.ts",
+      "default": "./dist/stores/lease-store.js"
+    },
+    "./stores/message-store": {
+      "types": "./dist/stores/message-store.d.ts",
+      "default": "./dist/stores/message-store.js"
+    },
+    "./stores/run-store": {
+      "types": "./dist/stores/run-store.d.ts",
+      "default": "./dist/stores/run-store.js"
+    },
+    "./stores/subscription-store": {
+      "types": "./dist/stores/subscription-store.d.ts",
+      "default": "./dist/stores/subscription-store.js"
+    }
+  }
+}