dotdo 0.0.1 → 0.1.0

package/dist/db/actions.js

@@ -0,0 +1,212 @@
+import { sqliteTable, text, integer, index } from 'drizzle-orm/sqlite-core';
+import { eq, or } from 'drizzle-orm';
+// ============================================================================
+// ACTIONS - Command Log (append-only)
+// ============================================================================
+//
+// Actions are the source of truth for all mutations.
+// They reference thing versions by rowid for before/after state.
+//
+// Every action has:
+//   - verb: what was done (FK to verbs, uses 'action' form like 'create')
+//   - actor: who did it (local path or URL)
+//   - target: what was affected (local path)
+//   - input: thing.rowid before the action (null for creates)
+//   - output: thing.rowid after the action (null for deletes)
+//   - options: additional parameters
+//
+// Time travel: Join actions with things to reconstruct state at any point.
+// ============================================================================
+export const actions = sqliteTable('actions', {
+    // rowid is implicit and serves as sequence number
+    // Identity
+    id: text('id').notNull().unique(), // UUID for external reference
+    // The action
+    verb: text('verb').notNull(), // 'create', 'update', 'delete' (action form)
+    // Actor and target (local paths within this DO)
+    actor: text('actor'), // 'Human/nathan', 'Agent/support'
+    target: text('target').notNull(), // 'Startup/acme'
+    // Version references (rowids into things table)
+    input: integer('input'), // things.rowid before (null for create)
+    output: integer('output'), // things.rowid after (null for delete)
+    // Additional parameters
+    options: text('options', { mode: 'json' }),
+    // Durability level
+    durability: text('durability', {
+        enum: ['send', 'try', 'do'],
+    })
+        .notNull()
+        .default('try'),
+    // Status
+    status: text('status', {
+        enum: ['pending', 'running', 'completed', 'failed', 'undone', 'retrying'],
+    })
+        .notNull()
+        .default('pending'),
+    error: text('error', { mode: 'json' }),
+    // Context (for correlation)
+    requestId: text('request_id'),
+    sessionId: text('session_id'),
+    workflowId: text('workflow_id'),
+    // Timing (derived, not source of truth for things)
+    startedAt: integer('started_at', { mode: 'timestamp' }),
+    completedAt: integer('completed_at', { mode: 'timestamp' }),
+    duration: integer('duration'), // ms
+    // Created timestamp (for this action record)
+    createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
+}, (table) => [
+    index('actions_verb_idx').on(table.verb),
+    index('actions_target_idx').on(table.target),
+    index('actions_actor_idx').on(table.actor),
+    index('actions_status_idx').on(table.status),
+    index('actions_request_idx').on(table.requestId),
+    index('actions_created_idx').on(table.createdAt),
+    index('actions_output_idx').on(table.output),
+]);
+// ============================================================================
+// ENUM/CONSTANT EXPORTS
+// ============================================================================
+/**
+ * Action status values
+ */
+export const ActionStatus = {
+    PENDING: 'pending',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    UNDONE: 'undone',
+    RETRYING: 'retrying',
+};
+/**
+ * Action durability values
+ */
+export const ActionDurability = {
+    SEND: 'send',
+    TRY: 'try',
+    DO: 'do',
+};
+// ============================================================================
+// QUERY HELPERS
+// ============================================================================
+/**
+ * Get all actions for a specific target.
+ * Uses the target index for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param target - The target path (e.g., 'Startup/acme')
+ * @returns Array of actions for the target
+ *
+ * @example
+ * ```ts
+ * const acmeActions = await getActionsByTarget(db, 'Startup/acme')
+ * ```
+ */
+export async function getActionsByTarget(db, target) {
+    return db
+        .select()
+        .from(actions)
+        .where(eq(actions.target, target));
+}
+/**
+ * Get all actions by a specific actor.
+ * Uses the actor index for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param actor - The actor path (e.g., 'Human/nathan', 'Agent/support')
+ * @returns Array of actions by the actor
+ *
+ * @example
+ * ```ts
+ * const nathanActions = await getActionsByActor(db, 'Human/nathan')
+ * ```
+ */
+export async function getActionsByActor(db, actor) {
+    return db
+        .select()
+        .from(actions)
+        .where(eq(actions.actor, actor));
+}
+/**
+ * Get all actions with a specific status.
+ * Uses the status index for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param status - The status to filter by
+ * @returns Array of actions with the status
+ *
+ * @example
+ * ```ts
+ * const failedActions = await getActionsByStatus(db, 'failed')
+ * ```
+ */
+export async function getActionsByStatus(db, status) {
+    return db
+        .select()
+        .from(actions)
+        .where(eq(actions.status, status));
+}
+/**
+ * Get all pending actions.
+ * Convenience wrapper around getActionsByStatus.
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of pending actions
+ */
+export async function getPendingActions(db) {
+    return getActionsByStatus(db, 'pending');
+}
+/**
+ * Get all running actions.
+ * Convenience wrapper around getActionsByStatus.
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of running actions
+ */
+export async function getRunningActions(db) {
+    return getActionsByStatus(db, 'running');
+}
+/**
+ * Get all failed actions.
+ * Convenience wrapper around getActionsByStatus.
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of failed actions
+ */
+export async function getFailedActions(db) {
+    return getActionsByStatus(db, 'failed');
+}
+/**
+ * Get action history for a thing by its rowid.
+ * Finds all actions where this thing version was the input or output.
+ *
+ * @param db - Drizzle database instance
+ * @param thingRowid - The things.rowid to look up history for
+ * @returns Array of actions involving this thing version
+ *
+ * @example
+ * ```ts
+ * const history = await getActionHistory(db, 42)
+ * ```
+ */
+export async function getActionHistory(db, thingRowid) {
+    return db
+        .select()
+        .from(actions)
+        .where(or(eq(actions.input, thingRowid), eq(actions.output, thingRowid)));
+}
+/**
+ * Calculate duration in milliseconds between two timestamps.
+ *
+ * @param startedAt - Start timestamp
+ * @param completedAt - End timestamp
+ * @returns Duration in milliseconds
+ *
+ * @example
+ * ```ts
+ * const duration = calculateDuration(action.startedAt, action.completedAt)
+ * ```
+ */
+export function calculateDuration(startedAt, completedAt) {
+    return completedAt.getTime() - startedAt.getTime();
+}
+//# sourceMappingURL=actions.js.map

package/dist/db/actions.js.map

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