@to11ai/sdk 1.1.0 → 2.0.0-rc.10

package/dist/prompts/cache.d.ts

@@ -1,59 +0,0 @@
-import type { FetchedPrompt, ResolvedPrompt } from "./types";
-export interface CacheConfig {
-    /** Time-to-live in seconds. Default: 300 (5 minutes) */
-    ttlSeconds?: number;
-    /** Maximum number of entries. Default: 100 */
-    maxEntries?: number;
-}
-/**
- * The cache stores either a legacy `resolve()` result or an enriched
- * `fetch()` result. Both are JSON-cloneable; the cache is shape-agnostic.
- */
-export type CacheableResolved = ResolvedPrompt | FetchedPrompt;
-/**
- * Build a canonical cache key for a resolve() call.
- *
- * - projectId is included to prevent cross-project cache collisions: a single
- *   PromptResource can serve multiple projects, so the same slug+labels must
- *   not share a cache entry across different projects.
- * - Labels are sorted alphabetically so ["production", "en"] and ["en", "production"]
- *   map to the same key.
- * - Variables are canonicalized with deterministic sorted-keys JSON before hashing.
- * - Each segment is JSON-encoded so that separator characters in slug or label
- *   values cannot cause key collisions (e.g. a slug containing "|" or ",").
- */
-export declare function buildCacheKey(projectId: string, slug: string, labels: string[], variables?: Record<string, unknown>): string;
-/**
- * Build a cache key for an env-aware `fetch()` call.
- *
- * Folds in `env` and `subject` ON TOP of the base
- * project/slug/labels/variables key so two calls that differ only by
- * env/subject do not return a stale cross-env / cross-cohort hit
- * (spec §3 "Caching key changes"). The env slug is also forwarded as the
- * single resolution label (env→label mapping, correction #3), so it appears
- * in the `labels` segment too; including it explicitly here keeps the key
- * unambiguous and self-documenting.
- *
- * `subject` participates in the key so a `subject`-keyed weighted assignment
- * caches as the same deterministic variant on repeat (D8); the
- * weighted-no-subject bypass is handled in the resource, not here.
- */
-export declare function buildFetchCacheKey(projectId: string, slug: string, env: string, subject?: string, variables?: Record<string, unknown>, developerRole?: string): string;
-/**
- * In-memory LRU cache for ResolvedPrompt objects.
- *
- * Uses a Map (insertion-ordered) as the backing store. On every access, the
- * entry is deleted and re-inserted to maintain LRU order — oldest entries sit
- * at the front of the Map.
- */
-export declare class PromptCache {
-    private readonly ttlMs;
-    private readonly maxEntries;
-    private readonly store;
-    constructor(config?: CacheConfig);
-    get(key: string): CacheableResolved | undefined;
-    set(key: string, value: CacheableResolved): void;
-    delete(key: string): void;
-    clear(): void;
-    get size(): number;
-}

package/dist/routingRules/resource.cjs

@@ -1,138 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toCommonJS = (from) => {
-  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(entry, key))
-        __defProp(entry, key, {
-          get: __accessProp.bind(from, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-  }
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __moduleCache;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-
-// src/routingRules/resource.ts
-var exports_resource = {};
-__export(exports_resource, {
-  RoutingRulesResource: () => RoutingRulesResource,
-  RoutingRuleVersionResource: () => RoutingRuleVersionResource,
-  RoutingRuleReleaseResource: () => RoutingRuleReleaseResource
-});
-module.exports = __toCommonJS(exports_resource);
-var import_zod = require("zod");
-var import_zod2 = require("../generated/zod.gen");
-function unwrap(envelope) {
-  if (envelope.data === null || envelope.data === undefined) {
-    throw new Error("API returned success but data is null");
-  }
-  return envelope.data;
-}
-function rulePath(projectId, ruleId) {
-  return `/v1/projects/${encodeURIComponent(projectId)}/routing/rules/${encodeURIComponent(ruleId)}`;
-}
-function versionsPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/versions`;
-}
-function versionPath(projectId, ruleId, versionId) {
-  return `${versionsPath(projectId, ruleId)}/${encodeURIComponent(versionId)}`;
-}
-function releasesPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/releases`;
-}
-function releasePath(projectId, ruleId, envSlug) {
-  return `${releasesPath(projectId, ruleId)}/${encodeURIComponent(envSlug)}`;
-}
-function releaseRollbackPath(projectId, ruleId, envSlug) {
-  return `${releasePath(projectId, ruleId, envSlug)}/rollback`;
-}
-
-class RoutingRuleVersionResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async create(input) {
-    const { projectId, ruleId, ...body } = input;
-    const envelope = await this.transport.request("POST", versionsPath(projectId, ruleId), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const envelope = await this.transport.request("GET", versionsPath(input.projectId, input.ruleId), { query });
-    return unwrap(envelope);
-  }
-  async get(input) {
-    const envelope = await this.transport.request("GET", versionPath(input.projectId, input.ruleId, input.versionId), {
-      decode: (data) => import_zod2.zRuleVersion.parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRuleReleaseResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async set(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("PUT", releasePath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async rollback(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("POST", releaseRollbackPath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const path = input.envSlug !== undefined ? releasePath(input.projectId, input.ruleId, input.envSlug) : releasesPath(input.projectId, input.ruleId);
-    const envelope = await this.transport.request("GET", path, {
-      query,
-      decode: (data) => import_zod.z.array(import_zod2.zRuleRelease).parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRulesResource {
-  versions;
-  releases;
-  constructor(transport) {
-    this.versions = new RoutingRuleVersionResource(transport);
-    this.releases = new RoutingRuleReleaseResource(transport);
-  }
-}

package/dist/routingRules/resource.js

@@ -1,98 +0,0 @@
-// src/routingRules/resource.ts
-import { z } from "zod";
-import { zRuleRelease, zRuleVersion } from "../generated/zod.gen";
-function unwrap(envelope) {
-  if (envelope.data === null || envelope.data === undefined) {
-    throw new Error("API returned success but data is null");
-  }
-  return envelope.data;
-}
-function rulePath(projectId, ruleId) {
-  return `/v1/projects/${encodeURIComponent(projectId)}/routing/rules/${encodeURIComponent(ruleId)}`;
-}
-function versionsPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/versions`;
-}
-function versionPath(projectId, ruleId, versionId) {
-  return `${versionsPath(projectId, ruleId)}/${encodeURIComponent(versionId)}`;
-}
-function releasesPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/releases`;
-}
-function releasePath(projectId, ruleId, envSlug) {
-  return `${releasesPath(projectId, ruleId)}/${encodeURIComponent(envSlug)}`;
-}
-function releaseRollbackPath(projectId, ruleId, envSlug) {
-  return `${releasePath(projectId, ruleId, envSlug)}/rollback`;
-}
-
-class RoutingRuleVersionResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async create(input) {
-    const { projectId, ruleId, ...body } = input;
-    const envelope = await this.transport.request("POST", versionsPath(projectId, ruleId), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const envelope = await this.transport.request("GET", versionsPath(input.projectId, input.ruleId), { query });
-    return unwrap(envelope);
-  }
-  async get(input) {
-    const envelope = await this.transport.request("GET", versionPath(input.projectId, input.ruleId, input.versionId), {
-      decode: (data) => zRuleVersion.parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRuleReleaseResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async set(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("PUT", releasePath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async rollback(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("POST", releaseRollbackPath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const path = input.envSlug !== undefined ? releasePath(input.projectId, input.ruleId, input.envSlug) : releasesPath(input.projectId, input.ruleId);
-    const envelope = await this.transport.request("GET", path, {
-      query,
-      decode: (data) => z.array(zRuleRelease).parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRulesResource {
-  versions;
-  releases;
-  constructor(transport) {
-    this.versions = new RoutingRuleVersionResource(transport);
-    this.releases = new RoutingRuleReleaseResource(transport);
-  }
-}
-export {
-  RoutingRulesResource,
-  RoutingRuleVersionResource,
-  RoutingRuleReleaseResource
-};

package/src/prompts/cache.ts

@@ -1,157 +0,0 @@
-import type { FetchedPrompt, ResolvedPrompt } from "./types";
-
-export interface CacheConfig {
-	/** Time-to-live in seconds. Default: 300 (5 minutes) */
-	ttlSeconds?: number;
-	/** Maximum number of entries. Default: 100 */
-	maxEntries?: number;
-}
-
-/**
- * The cache stores either a legacy `resolve()` result or an enriched
- * `fetch()` result. Both are JSON-cloneable; the cache is shape-agnostic.
- */
-export type CacheableResolved = ResolvedPrompt | FetchedPrompt;
-
-interface CacheEntry {
-	value: CacheableResolved;
-	expiresAt: number;
-}
-
-/**
- * Build a canonical cache key for a resolve() call.
- *
- * - projectId is included to prevent cross-project cache collisions: a single
- *   PromptResource can serve multiple projects, so the same slug+labels must
- *   not share a cache entry across different projects.
- * - Labels are sorted alphabetically so ["production", "en"] and ["en", "production"]
- *   map to the same key.
- * - Variables are canonicalized with deterministic sorted-keys JSON before hashing.
- * - Each segment is JSON-encoded so that separator characters in slug or label
- *   values cannot cause key collisions (e.g. a slug containing "|" or ",").
- */
-export function buildCacheKey(
-	projectId: string,
-	slug: string,
-	labels: string[],
-	variables?: Record<string, unknown>,
-): string {
-	const sortedLabels = [...labels].sort();
-	const varsPart =
-		variables !== undefined ? JSON.stringify(sortObjectKeys(variables)) : null;
-	// JSON.stringify each segment to prevent separator-character collisions
-	return `${JSON.stringify(projectId)}|${JSON.stringify(slug)}|${JSON.stringify(sortedLabels)}|${JSON.stringify(varsPart)}`;
-}
-
-/**
- * Build a cache key for an env-aware `fetch()` call.
- *
- * Folds in `env` and `subject` ON TOP of the base
- * project/slug/labels/variables key so two calls that differ only by
- * env/subject do not return a stale cross-env / cross-cohort hit
- * (spec §3 "Caching key changes"). The env slug is also forwarded as the
- * single resolution label (env→label mapping, correction #3), so it appears
- * in the `labels` segment too; including it explicitly here keeps the key
- * unambiguous and self-documenting.
- *
- * `subject` participates in the key so a `subject`-keyed weighted assignment
- * caches as the same deterministic variant on repeat (D8); the
- * weighted-no-subject bypass is handled in the resource, not here.
- */
-export function buildFetchCacheKey(
-	projectId: string,
-	slug: string,
-	env: string,
-	subject?: string,
-	variables?: Record<string, unknown>,
-	developerRole?: string,
-): string {
-	const base = buildCacheKey(projectId, slug, [env], variables);
-	// `developerRole` partitions the cache; coalesce the default so omitted and
-	// `"user"` (the documented default) share one entry, not two.
-	return `fetch|${base}|${JSON.stringify(env)}|${JSON.stringify(subject ?? null)}|${JSON.stringify(developerRole ?? "user")}`;
-}
-
-function sortObjectKeys(obj: unknown): unknown {
-	if (obj === null || typeof obj !== "object") return obj;
-	if (Array.isArray(obj)) return obj.map(sortObjectKeys);
-	const sorted: Record<string, unknown> = {};
-	for (const key of Object.keys(obj as Record<string, unknown>).sort()) {
-		sorted[key] = sortObjectKeys((obj as Record<string, unknown>)[key]);
-	}
-	return sorted;
-}
-
-/**
- * In-memory LRU cache for ResolvedPrompt objects.
- *
- * Uses a Map (insertion-ordered) as the backing store. On every access, the
- * entry is deleted and re-inserted to maintain LRU order — oldest entries sit
- * at the front of the Map.
- */
-export class PromptCache {
-	private readonly ttlMs: number;
-	private readonly maxEntries: number;
-	private readonly store: Map<string, CacheEntry>;
-
-	constructor(config?: CacheConfig) {
-		this.ttlMs = (config?.ttlSeconds ?? 300) * 1000;
-		this.maxEntries = config?.maxEntries ?? 100;
-		this.store = new Map();
-	}
-
-	get(key: string): CacheableResolved | undefined {
-		const entry = this.store.get(key);
-		if (!entry) return undefined;
-
-		if (Date.now() > entry.expiresAt) {
-			this.store.delete(key);
-			return undefined;
-		}
-
-		// Refresh LRU order — move to end
-		this.store.delete(key);
-		this.store.set(key, entry);
-
-		return entry.value;
-	}
-
-	set(key: string, value: CacheableResolved): void {
-		// maxEntries: 0 (or negative) means caching is disabled — drop the entry.
-		if (this.maxEntries <= 0) {
-			return;
-		}
-
-		// Remove existing entry so re-insertion moves it to the end
-		if (this.store.has(key)) {
-			this.store.delete(key);
-		}
-
-		// Evict least-recently-used entry if at capacity
-		while (this.store.size >= this.maxEntries) {
-			const lruKey = this.store.keys().next().value;
-			if (lruKey !== undefined) {
-				this.store.delete(lruKey);
-			} else {
-				break;
-			}
-		}
-
-		this.store.set(key, {
-			value,
-			expiresAt: Date.now() + this.ttlMs,
-		});
-	}
-
-	delete(key: string): void {
-		this.store.delete(key);
-	}
-
-	clear(): void {
-		this.store.clear();
-	}
-
-	get size(): number {
-		return this.store.size;
-	}
-}