@pepys/api 0.0.1 → 0.1.0

package/src/store-reader/read-offsets.ts

@@ -1,28 +1,33 @@
-import type { Result } from '@pepys/kit';
-import type { StoreReader } from './store-reader.ts';
+import type { ConsumerDeclaration, Result, StoreReader, StoreReaderFailure } from '@pepys/kit';
+import { sql } from 'kysely';
+import { z } from 'zod';
 
 interface Offset {
   stream: string;
   lastSeqNum: number;
 }
 
+const offsetRowSchema = z.object({ stream: z.string(), last_seq_num: z.number() });
+const offsetRowsSchema = z.object({ rows: z.array(offsetRowSchema) });
+
+// The last sequence number the host applied from each stream the consumer reads.
 export async function readOffsets(
   store: StoreReader,
-  consumerName: string,
-): Promise<Result<Offset[], { reason: 'no-current-version' }>> {
-  const result = await store.withConsumer(consumerName, (transaction) =>
-    transaction
-      .selectFrom('offsets')
-      .select(['stream', 'last_seq_num'])
-      .orderBy('stream')
-      .execute(),
+  consumer: ConsumerDeclaration,
+): Promise<Result<Offset[], StoreReaderFailure>> {
+  const table = sql.table(`${consumer.name}.offsets`);
+
+  const result = await store.withConsumers([consumer], (db) =>
+    sql`select stream, last_seq_num from ${table} order by stream`.execute(db),
   );
 
   if (!result.ok) {
     return result;
   }
 
-  const offsets = result.value.map((row) => ({ stream: row.stream, lastSeqNum: row.last_seq_num }));
+  const offsets = offsetRowsSchema
+    .parse(result.value)
+    .rows.map((row) => ({ stream: row.stream, lastSeqNum: row.last_seq_num }));
 
   return { ok: true, value: offsets };
 }

package/src/utils/compare-text.ts

@@ -0,0 +1,8 @@
+// Code unit order, as the default sort and SQLite's binary collation give, not the locale's.
+export function compareText(first: string, second: string): number {
+  if (first === second) {
+    return 0;
+  }
+
+  return first < second ? -1 : 1;
+}

package/src/change-feed/change-feed.ts

@@ -1,33 +0,0 @@
-import type { StreamOffset } from '@pepys/kit';
-
-export type ChangeMessage =
-  | {
-      kind: 'change';
-      type: string;
-      key: string;
-      value: unknown;
-      oldValue: unknown;
-      operation: 'insert' | 'update' | 'delete';
-    }
-  | { kind: 'snapshot-start' }
-  | { kind: 'snapshot-end' };
-
-export interface FeedStream {
-  consumer: string;
-  generation: number;
-}
-
-export type FeedPosition = StreamOffset | -1 | 'now';
-
-export type FeedRead =
-  | { kind: 'messages'; messages: readonly ChangeMessage[]; next: StreamOffset; atTail: boolean }
-  | { kind: 'closed'; currentGeneration: number }
-  | { kind: 'gone'; snapshotAt: StreamOffset };
-
-export interface ChangeFeed {
-  read: (
-    stream: FeedStream,
-    from: FeedPosition,
-    mode: 'catch-up' | 'long-poll',
-  ) => Promise<FeedRead>;
-}

package/src/principal/principal.ts

@@ -1,10 +0,0 @@
-import type { ClientID, GrantID } from '@pepys/kit';
-
-export type Scope = 'read' | 'write';
-
-export interface Principal {
-  client: ClientID;
-  clientName: string;
-  grant: GrantID;
-  scopes: readonly Scope[];
-}

package/src/queries/get-entity/find-entity-consumer.ts

@@ -1,23 +0,0 @@
-import type { ConsumerDeclaration, EntityIDParts, EntityViewDeclaration } from '@pepys/kit';
-
-export interface EntityConsumer {
-  consumer: ConsumerDeclaration;
-  entityView: EntityViewDeclaration;
-}
-
-export function findEntityConsumer(
-  consumers: readonly ConsumerDeclaration[],
-  parts: EntityIDParts,
-): EntityConsumer | undefined {
-  const kind = `${parts.source}:${parts.kind}`;
-
-  for (const consumer of consumers) {
-    const entityView = consumer.entityViews.find((view) => view.kind === kind);
-
-    if (entityView !== undefined) {
-      return { consumer, entityView };
-    }
-  }
-
-  return undefined;
-}

package/src/store-reader/open-consumer-database.ts

@@ -1,6 +0,0 @@
-import { connect } from '@tursodatabase/database';
-import type { Database } from '@tursodatabase/database';
-
-export function openConsumerDatabase(path: string): Promise<Database> {
-  return connect(path, { readonly: true, experimental: ['multiprocess_wal'] });
-}

package/src/store-reader/read-pull-requests.ts

@@ -1,13 +0,0 @@
-import type { Result } from '@pepys/kit';
-import type { Selectable } from 'kysely';
-import type { ConsumerDB, StoreReader } from './store-reader.ts';
-
-type PullRequestRow = Selectable<ConsumerDB['github_pull_request']>;
-
-export function readPullRequests(
-  store: StoreReader,
-): Promise<Result<PullRequestRow[], { reason: 'no-current-version' }>> {
-  return store.withConsumer('github_pull_request', (transaction) =>
-    transaction.selectFrom('github_pull_request').selectAll().orderBy('id').execute(),
-  );
-}

package/src/store-reader/store-reader.ts

@@ -1,37 +0,0 @@
-import type { Result } from '@pepys/kit';
-import type { DB } from '@pepys/schema';
-import type { Transaction } from 'kysely';
-
-interface EntityViewRow {
-  id: string;
-  kind: string;
-  title: string;
-  url: string;
-  actor: string | null;
-  updated_at: string;
-}
-
-// the host creates these two tables in every consumer file, beside the consumer's own
-interface OffsetRow {
-  stream: string;
-  last_seq_num: number;
-}
-
-interface ChangeLogRow {
-  batch: number;
-  changes: string;
-}
-
-export type ConsumerDB = DB & {
-  entity: EntityViewRow;
-  offsets: OffsetRow;
-  change_log: ChangeLogRow;
-};
-
-export interface StoreReader {
-  withConsumer: <Value>(
-    consumerName: string,
-    work: (transaction: Transaction<ConsumerDB>) => Promise<Value>,
-  ) => Promise<Result<Value, { reason: 'no-current-version' }>>;
-  close: () => Promise<void>;
-}