@propertysimple/client 0.1.0

package/contracts/src/smart-feed.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { ListingSchema, CatalogSourceFreshnessSchema } from './schemas.js';
+import { DirectoryEntitySchema, DirectoryRelationshipSchema } from './directory.js';
+import { DirectoryIdentityResolutionSchema } from './directory-identity.js';
+const Id = z.string().min(1).max(256);
+const Sequence = z.string().regex(/^\d+$/);
+const Time = z.iso.datetime({ offset: true });
+const Page = {
+    cursor: z.string().min(1).max(4096).optional(),
+    limit: z.coerce.number().int().min(1).max(200).default(100),
+};
+/** The selector is immutable for the lifetime of a snapshot/replay stream. */
+export const SmartFeedSelectorSchema = z.strictObject({
+    mode: z.enum(['directory', 'combined']).default('directory'),
+    party_id: Id.optional(),
+    inventory_basis: z.literal('listing_representation').default('listing_representation'),
+});
+export const SmartFeedResourceSchema = z
+    .discriminatedUnion('resource_type', [
+    z.strictObject({
+        resource_type: z.literal('identity_resolution'),
+        resource_id: Id,
+        revision: Sequence,
+        payload: z.lazy(() => DirectoryIdentityResolutionSchema),
+    }),
+    z.strictObject({
+        resource_type: z.literal('listing'),
+        resource_id: Id,
+        revision: Sequence,
+        payload: z.lazy(() => ListingSchema),
+    }),
+    z.strictObject({
+        resource_type: z.literal('entity'),
+        resource_id: Id,
+        revision: Sequence,
+        payload: z.lazy(() => DirectoryEntitySchema),
+    }),
+    z.strictObject({
+        resource_type: z.literal('relationship'),
+        resource_id: Id,
+        revision: Sequence,
+        payload: z.lazy(() => DirectoryRelationshipSchema),
+    }),
+])
+    .superRefine((resource, context) => {
+    if (resource.payload.id !== resource.resource_id ||
+        resource.payload.revision !== resource.revision)
+        context.addIssue({
+            code: 'custom',
+            message: 'Resource envelope must match payload identity and revision.',
+        });
+});
+export const SmartFeedChangeSchema = z.strictObject({
+    sequence: Sequence,
+    group_id: Id,
+    group_end_sequence: Sequence,
+    group_index: z.number().int().min(0),
+    group_size: z.number().int().positive(),
+    resource_type: z.enum(['listing', 'entity', 'relationship', 'identity_resolution']),
+    resource_id: Id,
+    revision: Sequence,
+    operation: z.enum(['upsert', 'remove']),
+    resource: SmartFeedResourceSchema.nullable(),
+});
+export const SmartFeedSnapshotSchema = z.strictObject({
+    id: Id,
+    dataset_id: Id,
+    status: z.enum(['ready', 'expired']),
+    schema_version: z.literal('smart-feed-v2'),
+    selector: SmartFeedSelectorSchema,
+    entitlement_fingerprint: z.string(),
+    snapshot_sequence: Sequence,
+    replay_cursor: z.string(),
+    created_at: Time,
+    expires_at: Time,
+});
+export const SmartFeedSnapshotPageSchema = z.strictObject({
+    data: z.array(SmartFeedResourceSchema),
+    has_more: z.boolean(),
+    next_cursor: z.string().nullable(),
+    meta: z.strictObject({
+        snapshot_sequence: Sequence,
+        source_freshness: z.array(z.lazy(() => CatalogSourceFreshnessSchema)),
+    }),
+});
+export const SmartFeedChangesSchema = z.strictObject({
+    data: z.array(SmartFeedChangeSchema),
+    has_more: z.boolean(),
+    next_cursor: z.string(),
+    meta: z.strictObject({
+        published_sequence: Sequence,
+        source_freshness: z.array(z.lazy(() => CatalogSourceFreshnessSchema)),
+    }),
+});
+export const smartFeedOperations = {
+    createDirectorySnapshot: {
+        input: z.strictObject({ dataset_id: Id, ...SmartFeedSelectorSchema.shape }),
+        output: SmartFeedSnapshotSchema,
+    },
+    getDirectorySnapshot: { input: z.strictObject({ id: Id }), output: SmartFeedSnapshotSchema },
+    listDirectorySnapshotItems: {
+        input: z.strictObject({ id: Id, ...Page }),
+        output: SmartFeedSnapshotPageSchema,
+    },
+    listDirectoryChanges: {
+        input: z.strictObject({ dataset_id: Id, ...SmartFeedSelectorSchema.shape, ...Page }),
+        output: SmartFeedChangesSchema,
+    },
+};