@typicalday/firegraph 0.11.2 → 0.13.0

package/dist/codegen/index.d.cts

@@ -1,4 +1,4 @@
-import { b as DiscoveryResult } from '../types-BGWxcpI_.cjs';
+import { l as DiscoveryResult } from '../backend-DuvHGgK1.cjs';
 import '@google-cloud/firestore';
 
 /**

package/dist/codegen/index.d.ts

@@ -1,4 +1,4 @@
-import { b as DiscoveryResult } from '../types-BGWxcpI_.js';
+import { l as DiscoveryResult } from '../backend-DuvHGgK1.js';
 import '@google-cloud/firestore';
 
 /**

package/dist/errors-BRc3I_eH.d.cts

@@ -0,0 +1,73 @@
+declare class FiregraphError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class NodeNotFoundError extends FiregraphError {
+    constructor(uid: string);
+}
+declare class EdgeNotFoundError extends FiregraphError {
+    constructor(aUid: string, axbType: string, bUid: string);
+}
+declare class ValidationError extends FiregraphError {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+declare class RegistryViolationError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string);
+}
+declare class InvalidQueryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class TraversalError extends FiregraphError {
+    constructor(message: string);
+}
+declare class DynamicRegistryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class QuerySafetyError extends FiregraphError {
+    constructor(message: string);
+}
+declare class RegistryScopeError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
+}
+declare class MigrationError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller tries to perform an operation that would require
+ * atomicity across two physical storage backends — e.g. opening a routed
+ * subgraph client from inside a transaction callback. Cross-backend
+ * atomicity cannot be honoured by real-world storage engines (Firestore,
+ * SQLite drivers over D1/DO/better-sqlite3, etc.), so firegraph surfaces
+ * this as a typed error instead of silently confining the write to the
+ * base backend.
+ *
+ * Normally `TransactionBackend` and `BatchBackend` don't expose `subgraph()`
+ * at the type level, so this error is unreachable through well-typed code.
+ * It exists as a public catchable type for app code that needs to tolerate
+ * this case deliberately (e.g. dynamic code paths that bypass the type
+ * system) and as future-proofing if the interface ever grows a way to
+ * request a sub-scope inside a transaction.
+ */
+declare class CrossBackendTransactionError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller invokes a capability-gated operation on a backend
+ * that does not declare the required capability. Capability gating is
+ * primarily a compile-time concern (see `BackendCapabilities` and the
+ * type-level extension surfaces in `GraphClient<C>`), but this runtime
+ * error covers the cases where the type system is bypassed — dynamic
+ * registries, `as any` casts, or callers explicitly downcasting through
+ * the generic-erased `StorageBackend` shape.
+ *
+ * The error code is `CAPABILITY_NOT_SUPPORTED`. The message names the
+ * missing capability and the backend that was asked, so app code can
+ * diagnose without inspecting the cap set itself.
+ */
+declare class CapabilityNotSupportedError extends FiregraphError {
+    readonly capability: string;
+    constructor(capability: string, backendDescription: string);
+}
+
+export { CapabilityNotSupportedError as C, DynamicRegistryError as D, EdgeNotFoundError as E, FiregraphError as F, InvalidQueryError as I, MigrationError as M, NodeNotFoundError as N, QuerySafetyError as Q, RegistryScopeError as R, TraversalError as T, ValidationError as V, CrossBackendTransactionError as a, RegistryViolationError as b };

package/dist/errors-BRc3I_eH.d.ts

@@ -0,0 +1,73 @@
+declare class FiregraphError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class NodeNotFoundError extends FiregraphError {
+    constructor(uid: string);
+}
+declare class EdgeNotFoundError extends FiregraphError {
+    constructor(aUid: string, axbType: string, bUid: string);
+}
+declare class ValidationError extends FiregraphError {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+declare class RegistryViolationError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string);
+}
+declare class InvalidQueryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class TraversalError extends FiregraphError {
+    constructor(message: string);
+}
+declare class DynamicRegistryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class QuerySafetyError extends FiregraphError {
+    constructor(message: string);
+}
+declare class RegistryScopeError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
+}
+declare class MigrationError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller tries to perform an operation that would require
+ * atomicity across two physical storage backends — e.g. opening a routed
+ * subgraph client from inside a transaction callback. Cross-backend
+ * atomicity cannot be honoured by real-world storage engines (Firestore,
+ * SQLite drivers over D1/DO/better-sqlite3, etc.), so firegraph surfaces
+ * this as a typed error instead of silently confining the write to the
+ * base backend.
+ *
+ * Normally `TransactionBackend` and `BatchBackend` don't expose `subgraph()`
+ * at the type level, so this error is unreachable through well-typed code.
+ * It exists as a public catchable type for app code that needs to tolerate
+ * this case deliberately (e.g. dynamic code paths that bypass the type
+ * system) and as future-proofing if the interface ever grows a way to
+ * request a sub-scope inside a transaction.
+ */
+declare class CrossBackendTransactionError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller invokes a capability-gated operation on a backend
+ * that does not declare the required capability. Capability gating is
+ * primarily a compile-time concern (see `BackendCapabilities` and the
+ * type-level extension surfaces in `GraphClient<C>`), but this runtime
+ * error covers the cases where the type system is bypassed — dynamic
+ * registries, `as any` casts, or callers explicitly downcasting through
+ * the generic-erased `StorageBackend` shape.
+ *
+ * The error code is `CAPABILITY_NOT_SUPPORTED`. The message names the
+ * missing capability and the backend that was asked, so app code can
+ * diagnose without inspecting the cap set itself.
+ */
+declare class CapabilityNotSupportedError extends FiregraphError {
+    readonly capability: string;
+    constructor(capability: string, backendDescription: string);
+}
+
+export { CapabilityNotSupportedError as C, DynamicRegistryError as D, EdgeNotFoundError as E, FiregraphError as F, InvalidQueryError as I, MigrationError as M, NodeNotFoundError as N, QuerySafetyError as Q, RegistryScopeError as R, TraversalError as T, ValidationError as V, CrossBackendTransactionError as a, RegistryViolationError as b };