dotdo 0.0.1 → 0.0.2

package/dist/db/nouns.js

@@ -0,0 +1,183 @@
+import { sqliteTable, text } from 'drizzle-orm/sqlite-core';
+import { eq, isNotNull } from 'drizzle-orm';
+import { z } from 'zod';
+// ============================================================================
+// NOUNS - Optional Type Registry (for validation/introspection, not required FK)
+// ============================================================================
+export const nouns = sqliteTable('nouns', {
+    noun: text('noun').primaryKey(), // 'Customer', 'Agent'
+    plural: text('plural'), // 'Customers', 'Agents'
+    description: text('description'),
+    schema: text('schema', { mode: 'json' }), // Field definitions
+    doClass: text('do_class'), // CF binding if DO subclass
+});
+/**
+ * Runtime type marker for Noun type.
+ * Since TypeScript types are erased at runtime, this provides
+ * a way to check if Noun type is exported at runtime.
+ * This is the table definition itself, useful for type-checking.
+ */
+export const Noun = nouns;
+/**
+ * Runtime type marker for NewNoun type.
+ * Since TypeScript types are erased at runtime, this provides
+ * a way to check if NewNoun type is exported at runtime.
+ * This is the table definition itself, useful for insert operations.
+ */
+export const NewNoun = nouns;
+// ============================================================================
+// QUERY HELPERS
+// ============================================================================
+/**
+ * Get a single noun by its primary key (noun name).
+ *
+ * @param db - Drizzle database instance
+ * @param nounName - The noun name to look up
+ * @returns The noun or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const customer = await getNoun(db, 'Customer')
+ * if (customer) {
+ *   console.log(`${customer.noun} -> ${customer.plural}`)
+ * }
+ * ```
+ */
+export async function getNoun(db, nounName) {
+    const results = await db
+        .select()
+        .from(nouns)
+        .where(eq(nouns.noun, nounName));
+    return results[0];
+}
+/**
+ * Get all nouns from the registry.
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of all nouns
+ *
+ * @example
+ * ```ts
+ * const allNouns = await getAllNouns(db)
+ * console.log(`Registry has ${allNouns.length} nouns`)
+ * ```
+ */
+export async function getAllNouns(db) {
+    return db.select().from(nouns);
+}
+/**
+ * Get all nouns that have a Durable Object binding (doClass is not null).
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of nouns with DO bindings
+ *
+ * @example
+ * ```ts
+ * const doNouns = await getNounsWithDO(db)
+ * doNouns.forEach(n => console.log(`${n.noun} -> ${n.doClass}`))
+ * ```
+ */
+export async function getNounsWithDO(db) {
+    return db
+        .select()
+        .from(nouns)
+        .where(isNotNull(nouns.doClass));
+}
+/**
+ * Get all nouns that have a schema defined (schema is not null).
+ *
+ * @param db - Drizzle database instance
+ * @returns Array of nouns with schemas
+ *
+ * @example
+ * ```ts
+ * const schemaNouns = await getNounsWithSchema(db)
+ * schemaNouns.forEach(n => console.log(`${n.noun} has schema`))
+ * ```
+ */
+export async function getNounsWithSchema(db) {
+    return db
+        .select()
+        .from(nouns)
+        .where(isNotNull(nouns.schema));
+}
+/**
+ * Check if a noun exists in the registry.
+ *
+ * @param db - Drizzle database instance
+ * @param nounName - The noun name to check
+ * @returns Boolean indicating if the noun exists
+ *
+ * @example
+ * ```ts
+ * const exists = await nounExists(db, 'Customer')
+ * if (!exists) {
+ *   // Register the noun
+ * }
+ * ```
+ */
+export async function nounExists(db, nounName) {
+    const noun = await getNoun(db, nounName);
+    return noun !== undefined;
+}
+// ============================================================================
+// VALIDATION SCHEMAS
+// ============================================================================
+/**
+ * Schema for noun field definitions
+ */
+export const NounFieldSchema = z.object({
+    type: z.string(),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+    default: z.unknown().optional(),
+});
+/**
+ * Schema for validating noun schema structure.
+ * This validates the JSON stored in the schema column.
+ */
+export const NounSchemaValidator = z.object({
+    type: z.string(),
+    fields: z.record(z.string(), NounFieldSchema).optional(),
+    validators: z.array(z.string()).optional(),
+    computed: z.array(z.string()).optional(),
+}).passthrough();
+/**
+ * Validate a noun schema object.
+ * Returns the validated schema or throws a ZodError.
+ *
+ * @param schema - The schema object to validate
+ * @returns Validated schema object
+ *
+ * @example
+ * ```ts
+ * const schema = validateNounSchema({
+ *   type: 'entity',
+ *   fields: { name: { type: 'string', required: true } }
+ * })
+ * ```
+ */
+export function validateNounSchema(schema) {
+    return NounSchemaValidator.parse(schema);
+}
+/**
+ * Check if a noun name follows the PascalCase naming convention.
+ *
+ * @param noun - The noun name to validate
+ * @returns Boolean indicating if the name is valid
+ *
+ * @example
+ * ```ts
+ * isValidNounName('Customer')    // true
+ * isValidNounName('customer')    // false (lowercase)
+ * isValidNounName('my-noun')     // false (contains dash)
+ * isValidNounName('MyNoun123')   // true
+ * ```
+ */
+export function isValidNounName(noun) {
+    // Must start with uppercase letter, can contain letters and numbers
+    // PascalCase pattern: starts with uppercase, followed by alphanumeric
+    const pascalCasePattern = /^[A-Z][a-zA-Z0-9]*$/;
+    return pascalCasePattern.test(noun);
+}
+//# sourceMappingURL=nouns.js.map

package/dist/db/nouns.js.map

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

package/dist/db/objects.js

@@ -0,0 +1,170 @@
+import { sqliteTable, text, integer, index } from 'drizzle-orm/sqlite-core';
+import { eq } from 'drizzle-orm';
+// ============================================================================
+// OBJECTS - DO-to-DO References (ns → CF DO ID mapping)
+// ============================================================================
+//
+// Maps namespace URLs to Cloudflare Durable Object IDs.
+// Used for cross-DO resolution and geo-replication.
+//
+// ============================================================================
+// ============================================================================
+// ENUM CONSTANTS
+// ============================================================================
+/**
+ * Valid relation types for DO-to-DO relationships
+ */
+export const ObjectRelation = {
+    parent: 'parent',
+    child: 'child',
+    follower: 'follower',
+    shard: 'shard',
+    reference: 'reference',
+};
+// ============================================================================
+// TABLE SCHEMA
+// ============================================================================
+export const objects = sqliteTable('objects', {
+    // The namespace URL (which IS the DO's identity - fully qualified)
+    ns: text('ns').primaryKey(), // 'https://startups.studio'
+    // Cloudflare DO binding
+    id: text('id').notNull(), // CF Durable Object ID
+    class: text('class').notNull(), // CF binding: 'DO', 'Startup', etc.
+    // Relationship type
+    relation: text('relation', {
+        enum: ['parent', 'child', 'follower', 'shard', 'reference'],
+    }),
+    // For sharding
+    shardKey: text('shard_key'),
+    shardIndex: integer('shard_index'),
+    // For geo-replication
+    region: text('region'),
+    primary: integer('primary', { mode: 'boolean' }),
+    // Cached data (denormalized for display)
+    cached: text('cached', { mode: 'json' }),
+    // Created timestamp
+    createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
+}, (table) => [
+    index('obj_id_idx').on(table.id),
+    index('obj_relation_idx').on(table.relation),
+    index('obj_shard_idx').on(table.shardKey, table.shardIndex),
+    index('obj_region_idx').on(table.region),
+]);
+// ============================================================================
+// QUERY HELPERS
+// ============================================================================
+/**
+ * Get a single object by namespace URL.
+ * Uses the primary key for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param ns - The namespace URL to look up
+ * @returns The object record or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const obj = await getObject(db, 'https://startups.studio')
+ * if (obj) {
+ *   console.log(`Found DO: ${obj.id} (${obj.class})`)
+ * }
+ * ```
+ */
+export async function getObject(db, ns) {
+    const results = await db
+        .select()
+        .from(objects)
+        .where(eq(objects.ns, ns));
+    return results[0];
+}
+/**
+ * Register a new Durable Object in the objects table.
+ *
+ * @param db - Drizzle database instance
+ * @param data - The object data to insert
+ * @returns The inserted object record
+ *
+ * @example
+ * ```ts
+ * const obj = await registerObject(db, {
+ *   ns: 'https://startups.studio',
+ *   id: 'DO_ID_abc123',
+ *   class: 'Startup',
+ *   createdAt: new Date(),
+ * })
+ * ```
+ */
+export async function registerObject(db, data) {
+    const results = await db
+        .insert(objects)
+        .values(data)
+        .returning();
+    return results[0];
+}
+/**
+ * Get all objects with a specific relation type.
+ * Uses the relation index for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param relation - The relation type to filter by
+ * @returns Array of objects with the specified relation
+ *
+ * @example
+ * ```ts
+ * const children = await getObjectsByRelation(db, 'child')
+ * console.log(`Found ${children.length} child objects`)
+ * ```
+ */
+export async function getObjectsByRelation(db, relation) {
+    return db
+        .select()
+        .from(objects)
+        .where(eq(objects.relation, relation));
+}
+/**
+ * Get all shards for a given shard key.
+ * Uses the composite shard index for efficient lookup.
+ *
+ * @param db - Drizzle database instance
+ * @param shardKey - The shard key to look up
+ * @returns Array of shard objects
+ *
+ * @example
+ * ```ts
+ * const shards = await getShards(db, 'users')
+ * console.log(`Found ${shards.length} shards for 'users'`)
+ * ```
+ */
+export async function getShards(db, shardKey) {
+    return db
+        .select()
+        .from(objects)
+        .where(eq(objects.shardKey, shardKey));
+}
+/**
+ * Get the primary replica for a namespace (geo-replication).
+ * Looks up the object and returns it if it's marked as primary.
+ *
+ * @param db - Drizzle database instance
+ * @param ns - The namespace URL to look up
+ * @returns The primary replica or undefined if not found or not primary
+ *
+ * @example
+ * ```ts
+ * const primary = await getPrimaryReplica(db, 'https://startups.studio')
+ * if (primary) {
+ *   console.log(`Primary is in region: ${primary.region}`)
+ * }
+ * ```
+ */
+export async function getPrimaryReplica(db, ns) {
+    const results = await db
+        .select()
+        .from(objects)
+        .where(eq(objects.ns, ns));
+    const obj = results[0];
+    if (obj && obj.primary === true) {
+        return obj;
+    }
+    return undefined;
+}
+//# sourceMappingURL=objects.js.map

package/dist/db/objects.js.map

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