@powersync/service-types 0.17.0 → 0.19.0

package/dist/routes.d.ts

@@ -28,7 +28,7 @@ export declare const ExecuteSqlRequest: t.ObjectCodec<{
     connection_id: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
     sql: t.ObjectCodec<{
         query: t.IdentityCodec<t.CodecType.String>;
-        args: t.ArrayCodec<t.Union<t.Codec<string | number, string | number, string, t.CodecProps>, t.IdentityCodec<t.CodecType.Boolean>>>;
+        args: t.ArrayCodec<t.Codec<string | number | boolean, string | number | boolean>>;
     }>;
 }>;
 export type ExecuteSqlRequest = t.Encoded<typeof ExecuteSqlRequest>;
@@ -36,7 +36,7 @@ export declare const ExecuteSqlResponse: t.ObjectCodec<{
     success: t.IdentityCodec<t.CodecType.Boolean>;
     results: t.ObjectCodec<{
         columns: t.ArrayCodec<t.IdentityCodec<t.CodecType.String>>;
-        rows: t.ArrayCodec<t.ArrayCodec<t.Union<t.Codec<string | number | boolean, string | number | boolean, string, t.CodecProps>, t.Codec<null, null, t.CodecType.Null, t.CodecProps>>>>;
+        rows: t.ArrayCodec<t.ArrayCodec<t.Codec<string | number | boolean | null, string | number | boolean | null>>>;
     }>;
     /** Set if success = false */
     error: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
@@ -55,7 +55,7 @@ export declare const DiagnosticsResponse: t.ObjectCodec<{
         postgres_uri: t.IdentityCodec<t.CodecType.String>;
         connected: t.IdentityCodec<t.CodecType.Boolean>;
         errors: t.ArrayCodec<t.ObjectCodec<{
-            level: t.Union<t.Codec<"warning", "warning", string, t.CodecProps>, t.LiteralCodec<"fatal">>;
+            level: t.Codec<"warning" | "fatal", "warning" | "fatal">;
             message: t.IdentityCodec<t.CodecType.String>;
             location: t.OptionalCodec<t.Codec<{
                 start_offset: number;
@@ -112,6 +112,7 @@ export declare const DiagnosticsResponse: t.ObjectCodec<{
             safe_wal_size?: number | undefined;
             max_slot_wal_keep_size?: number | undefined;
         }[];
+        version_label?: string | null | undefined;
         content?: string | undefined;
     }, {
         errors: {
@@ -153,6 +154,7 @@ export declare const DiagnosticsResponse: t.ObjectCodec<{
             safe_wal_size?: number | undefined;
             max_slot_wal_keep_size?: number | undefined;
         }[];
+        version_label?: string | null | undefined;
         content?: string | undefined;
     }, string, t.CodecProps>>;
     /**
@@ -202,6 +204,7 @@ export declare const DiagnosticsResponse: t.ObjectCodec<{
             safe_wal_size?: number | undefined;
             max_slot_wal_keep_size?: number | undefined;
         }[];
+        version_label?: string | null | undefined;
         content?: string | undefined;
     }, {
         errors: {
@@ -243,6 +246,7 @@ export declare const DiagnosticsResponse: t.ObjectCodec<{
             safe_wal_size?: number | undefined;
             max_slot_wal_keep_size?: number | undefined;
         }[];
+        version_label?: string | null | undefined;
         content?: string | undefined;
     }, string, t.CodecProps>>;
 }>;
@@ -262,6 +266,7 @@ export declare const ValidateRequest: t.ObjectCodec<{
 }>;
 export type ValidateRequest = t.Encoded<typeof ValidateRequest>;
 export declare const ValidateResponse: t.ObjectCodec<{
+    version_label: t.OptionalCodec<t.Codec<string | null, string | null, string, t.CodecProps>>;
     content: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
     connections: t.ArrayCodec<t.ObjectCodec<{
         id: t.IdentityCodec<t.CodecType.String>;
@@ -283,7 +288,7 @@ export declare const ValidateResponse: t.ObjectCodec<{
             data_queries: t.IdentityCodec<t.CodecType.Boolean>;
             parameter_queries: t.IdentityCodec<t.CodecType.Boolean>;
             errors: t.ArrayCodec<t.ObjectCodec<{
-                level: t.Union<t.Codec<"warning", "warning", string, t.CodecProps>, t.LiteralCodec<"fatal">>;
+                level: t.Codec<"warning" | "fatal", "warning" | "fatal">;
                 message: t.IdentityCodec<t.CodecType.String>;
                 location: t.OptionalCodec<t.Codec<{
                     start_offset: number;
@@ -297,7 +302,7 @@ export declare const ValidateResponse: t.ObjectCodec<{
         }>>;
     }>>;
     errors: t.ArrayCodec<t.ObjectCodec<{
-        level: t.Union<t.Codec<"warning", "warning", string, t.CodecProps>, t.LiteralCodec<"fatal">>;
+        level: t.Codec<"warning" | "fatal", "warning" | "fatal">;
         message: t.IdentityCodec<t.CodecType.String>;
         location: t.OptionalCodec<t.Codec<{
             start_offset: number;

package/dist/routes.js

@@ -1,4 +1,5 @@
 import * as t from 'ts-codec';
+import { anyPrimitive } from './codecs.js';
 import { ConnectionStatus, InstanceSchema, SyncRulesStatus } from './definitions.js';
 export const GetSchemaRequest = t.object({});
 export const GetSchemaResponse = InstanceSchema;
@@ -6,14 +7,14 @@ export const ExecuteSqlRequest = t.object({
     connection_id: t.string.optional(),
     sql: t.object({
         query: t.string,
-        args: t.array(t.string.or(t.number).or(t.boolean))
+        args: t.array(anyPrimitive({ string: true, number: true, boolean: true }))
     })
 });
 export const ExecuteSqlResponse = t.object({
     success: t.boolean,
     results: t.object({
         columns: t.array(t.string),
-        rows: t.array(t.array(t.string.or(t.number).or(t.boolean).or(t.Null)))
+        rows: t.array(t.array(anyPrimitive({ string: true, number: true, boolean: true, null: true })))
     }),
     /** Set if success = false */
     error: t.string.optional()

package/dist/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAG7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAGhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM;QACf,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;KACnD,CAAC;CACH,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KACvE,CAAC;IACF,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAEtC;;;;OAIG;IACH,iBAAiB,EAAE,eAAe,CAAC,QAAQ,EAAE;IAE7C;;;;;;OAMG;IACH,oBAAoB,EAAE,eAAe,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAG7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;QACvB,GAAG,EAAE,CAAC,CAAC,MAAM;QACb,SAAS,EAAE,CAAC,CAAC,MAAM;KACpB,CAAC,CACH;CACF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAG7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAGhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM;QACf,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;KAC3E,CAAC;CACH,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;KAChG,CAAC;IACF,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAEtC;;;;OAIG;IACH,iBAAiB,EAAE,eAAe,CAAC,QAAQ,EAAE;IAE7C;;;;;;OAMG;IACH,oBAAoB,EAAE,eAAe,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAG7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;QACvB,GAAG,EAAE,CAAC,CAAC,MAAM;QACb,SAAS,EAAE,CAAC,CAAC,MAAM;KACpB,CAAC,CACH;CACF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/service-types",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "exports": "./dist/index.js",
   "license": "FSL-1.1-ALv2",
   "type": "module",
@@ -13,8 +13,12 @@
     "ts-codec": "^1.3.0",
     "uri-js": "^4.4.1"
   },
+  "devDependencies": {
+    "vitest": "^4.1.5"
+  },
   "scripts": {
     "clean": "rm -r ./dist && tsc -b --clean",
-    "build": "tsc -b"
+    "build": "tsc -b",
+    "test": "vitest"
   }
 }

package/src/codecs.ts

@@ -0,0 +1,112 @@
+import type { AnyCodec, Codec, Ix, Ox, Union } from 'ts-codec';
+import * as t from 'ts-codec';
+
+/**
+ * An optimized codec equivalent to `type.or(Null)`.
+ */
+export function orNull<T extends AnyCodec>(type: T): Codec<Ix<T> | null, Ox<T> | null> {
+  return t.codec(
+    t.CodecType.Union,
+    (data) => {
+      if (data === null) {
+        return null;
+      }
+      return type.encode(data);
+    },
+    (data) => {
+      if (data === null) {
+        return null;
+      }
+      return type.decode(data);
+    },
+    {
+      codecs: [type, t.Null]
+    } satisfies Union<T, typeof t.Null>['props']
+  );
+}
+
+/**
+ * A codec parsing a static enumeration of literals.
+ *
+ * `enumLiteral('foo', 'bar')` is an equivalent but more efficient implementation of
+ * `literal('foo').or(literal('bar'))`
+ */
+export function enumLiteral<T extends string>(...values: T[]): Codec<T, T> {
+  function validate(source: unknown): T {
+    function invalid(): never {
+      const allowed = values.join(', ');
+      throw new t.TransformError(`Expected one of ${allowed}, but got ${source}`);
+    }
+
+    if (typeof source !== 'string') invalid();
+    if (!values.includes(source as T)) invalid();
+
+    return source as T;
+  }
+
+  return t.codec(t.CodecType.Enum, validate, validate, {
+    enum: values
+  });
+}
+
+type NamedPrimitiveTypes = {
+  string: string;
+  number: number;
+  boolean: boolean;
+  null: null;
+};
+
+const primitiveCodecs: Record<keyof NamedPrimitiveTypes, AnyCodec> = {
+  string: t.string,
+  number: t.number,
+  boolean: t.boolean,
+  null: t.Null
+};
+
+type EnabledKeys<T> = {
+  [K in keyof T]: T[K] extends true ? K : never;
+}[keyof T];
+
+type PrimitiveUnion<T extends Partial<Record<keyof NamedPrimitiveTypes, boolean>>> = NamedPrimitiveTypes[Extract<
+  EnabledKeys<T>,
+  keyof NamedPrimitiveTypes
+>];
+
+/**
+ * Parses multiple primitive types.
+ *
+ * `anyPrimitive({ boolean: true, string: true })` behaves identical to `boolean.or(string)`, but is more efficient.
+ */
+export function anyPrimitive<const T extends Partial<Record<keyof NamedPrimitiveTypes, boolean>>>(
+  allowedPrimitives: T
+): Codec<PrimitiveUnion<T>, PrimitiveUnion<T>> {
+  function validate(source: unknown): PrimitiveUnion<T> {
+    switch (typeof source) {
+      case 'string':
+        if (allowedPrimitives.string) return source as PrimitiveUnion<T>;
+        break;
+      case 'number':
+        if (allowedPrimitives.number) return source as PrimitiveUnion<T>;
+        break;
+      case 'boolean':
+        if (allowedPrimitives.boolean) return source as PrimitiveUnion<T>;
+        break;
+      case 'object':
+        if (allowedPrimitives.null && source === null) return source as PrimitiveUnion<T>;
+        break;
+    }
+
+    throw new t.TransformError(`Primitive value ${source} is not allowed.`);
+  }
+
+  const codecsForSchema: AnyCodec[] = [];
+  for (const [key, value] of Object.entries(allowedPrimitives)) {
+    if (value) {
+      codecsForSchema.push(primitiveCodecs[key as keyof NamedPrimitiveTypes]);
+    }
+  }
+
+  return t.codec(t.CodecType.Union, validate, validate, {
+    codecs: codecsForSchema
+  } satisfies Union<AnyCodec, AnyCodec>['props']);
+}

package/src/config/PowerSyncConfig.ts

@@ -1,5 +1,6 @@
 import dedent from 'dedent';
 import * as t from 'ts-codec';
+import { anyPrimitive, enumLiteral } from '../codecs.js';
 
 /**
  * The meta tags here are used in the generated JSON schema.
@@ -96,10 +97,7 @@ export const jwkRSA = t
     e: t.string.meta({
       description: 'RSA exponent, Base64 URL encoded.'
     }),
-    alg: t
-      .literal('RS256')
-      .or(t.literal('RS384'))
-      .or(t.literal('RS512'))
+    alg: enumLiteral('RS256', 'RS384', 'RS512')
       .meta({
         description: 'The algorithm intended for use with this key (RS256, RS384, or RS512).'
       })
@@ -128,7 +126,7 @@ export const jwkHmac = t
     k: t.string.meta({
       description: 'The HMAC key value, Base64 URL encoded.'
     }),
-    alg: t.literal('HS256').or(t.literal('HS384')).or(t.literal('HS512')).meta({
+    alg: enumLiteral('HS256', 'HS384', 'HS512').meta({
       description: 'The algorithm intended for use with this key (HS256, HS384, or HS512).'
     }),
     use: t.string
@@ -152,7 +150,7 @@ export const jwkOKP = t
       })
       .optional(),
     /** Other curves have security issues so only these two are supported. */
-    crv: t.literal('Ed25519').or(t.literal('Ed448')).meta({
+    crv: enumLiteral('Ed25519', 'Ed448').meta({
       description: 'The cryptographic curve used with this key. Only Ed25519 and Ed448 are supported.'
     }),
     x: t.string.meta({
@@ -182,7 +180,7 @@ export const jwkEC = t
         description: 'Key ID, a unique identifier for the key.'
       })
       .optional(),
-    crv: t.literal('P-256').or(t.literal('P-384')).or(t.literal('P-521')).meta({
+    crv: enumLiteral('P-256', 'P-384', 'P-521').meta({
       description: 'The cryptographic curve used with this key (P-256, P-384, or P-521).'
     }),
     x: t.string.meta({
@@ -191,7 +189,7 @@ export const jwkEC = t
     y: t.string.meta({
       description: 'The y coordinate for the Elliptic Curve point, Base64 URL encoded.'
     }),
-    alg: t.literal('ES256').or(t.literal('ES384')).or(t.literal('ES512')).meta({
+    alg: enumLiteral('ES256', 'ES384', 'ES512').meta({
       description: 'The algorithm intended for use with this key (ES256, ES384, or ES512).'
     }),
     use: t.string
@@ -204,7 +202,7 @@ export const jwkEC = t
     description: 'JSON Web Key (JWK) representation of an Elliptic Curve key.'
   });
 
-const jwk = t.union(t.union(t.union(jwkRSA, jwkHmac), jwkOKP), jwkEC).meta({
+const jwk = jwkRSA.or(jwkHmac).or(jwkOKP).or(jwkEC).meta({
   description: 'A JSON Web Key (JWK) representing a cryptographic key. Can be RSA, HMAC, OKP, or EC key types.'
 });
 
@@ -222,21 +220,12 @@ export type StrictJwk = t.Decoded<typeof jwk>;
 
 export const LoggingConfig = t
   .object({
-    level: t
-      .literal('silly')
-      .or(t.literal('debug'))
-      .or(t.literal('verbose'))
-      .or(t.literal('http'))
-      .or(t.literal('info'))
-      .or(t.literal('warn'))
-      .or(t.literal('error'))
+    level: enumLiteral('silly', 'debug', 'verbose', 'http', 'info', 'warn', 'error')
       .meta({
         description: 'Log level for the service logs.'
       })
       .optional(),
-    format: t
-      .literal('json')
-      .or(t.literal('text'))
+    format: enumLiteral('json', 'text')
       .meta({
         description: 'Log output format.'
       })
@@ -257,6 +246,11 @@ export const BaseStorageConfig = t
       .meta({
         description: 'Maximum number of connections to the storage database, per process. Defaults to 8.'
       })
+      .optional(),
+    default_storage_version: t.number
+      .meta({
+        description: 'Storage version to use when deploying a sync config that does not specify storage_version.'
+      })
       .optional()
   })
   .meta({
@@ -276,6 +270,11 @@ export type GenericStorageConfig = t.Encoded<typeof GenericStorageConfig>;
 
 export const SyncConfig = t
   .object({
+    version_label: t.string
+      .meta({
+        description: 'Optional label identifying this deployed sync config version.'
+      })
+      .optional(),
     path: t.string
       .meta({
         description: 'Path to the sync config YAML file.'
@@ -538,7 +537,7 @@ export const powerSyncConfig = t
       .optional(),
 
     parameters: t
-      .record(t.number.or(t.string).or(t.boolean).or(t.Null))
+      .record(anyPrimitive({ null: true, number: true, string: true, boolean: true }))
       .meta({
         description: 'Global parameters that can be referenced in sync config and other configurations.'
       })

package/src/definitions.ts

@@ -1,4 +1,5 @@
 import * as t from 'ts-codec';
+import { enumLiteral, orNull } from './codecs.js';
 
 export const SourceSpan = t.object({
   start_offset: t.number,
@@ -8,7 +9,7 @@ export type SourceSpan = t.Encoded<typeof SourceSpan>;
 
 export const ReplicationError = t.object({
   /** Warning: Could indicate an issue. Fatal: Prevents replicating. */
-  level: t.literal('warning').or(t.literal('fatal')),
+  level: enumLiteral('warning', 'fatal'),
   message: t.string,
   location: SourceSpan.optional(),
   ts: t.string.optional()
@@ -35,6 +36,10 @@ export const TableInfo = t.object({
 export type TableInfo = t.Encoded<typeof TableInfo>;
 
 export const SyncRulesStatus = t.object({
+  /**
+   * Optional label identifying this deployed sync config version.
+   */
+  version_label: orNull(t.string).optional(),
   content: t.string.optional(),
   connections: t.array(
     t.object({

package/src/index.ts

@@ -1,5 +1,6 @@
 export * as configFile from './config/PowerSyncConfig.js';
 
+export * from './codecs.js';
 export * from './definitions.js';
 export * from './metrics.js';
 export * as metric_types from './metrics.js';

package/src/metrics.ts

@@ -26,8 +26,14 @@ export enum ReplicationMetric {
 export enum StorageMetric {
   // Size of current replication data stored in PowerSync
   REPLICATION_SIZE_BYTES = 'powersync_replication_storage_size_bytes',
+  ATTRIBUTED_SOURCE_RECORDS_BYTES = 'powersync_attributed_source_records_bytes',
   // Size of operations data stored in PowerSync
   OPERATION_SIZE_BYTES = 'powersync_operation_storage_size_bytes',
+  ATTRIBUTED_BUCKET_DATA_BYTES = 'powersync_attributed_bucket_data_bytes',
   // Size of parameter data stored in PowerSync
-  PARAMETER_SIZE_BYTES = 'powersync_parameter_storage_size_bytes'
+  PARAMETER_SIZE_BYTES = 'powersync_parameter_storage_size_bytes',
+  ATTRIBUTED_PARAMETER_INDEXES_BYTES = 'powersync_attributed_parameter_indexes_bytes',
+  // Size of active S3 object-storage references stored in PowerSync
+  OBJECT_STORAGE_SIZE_BYTES = 'powersync_object_storage_size_bytes',
+  ATTRIBUTED_OBJECT_STORAGE_BYTES = 'powersync_attributed_object_storage_bytes'
 }

package/src/routes.ts

@@ -1,4 +1,5 @@
 import * as t from 'ts-codec';
+import { anyPrimitive } from './codecs.js';
 import { ConnectionStatus, InstanceSchema, SyncRulesStatus } from './definitions.js';
 
 export const GetSchemaRequest = t.object({});
@@ -11,7 +12,7 @@ export const ExecuteSqlRequest = t.object({
   connection_id: t.string.optional(),
   sql: t.object({
     query: t.string,
-    args: t.array(t.string.or(t.number).or(t.boolean))
+    args: t.array(anyPrimitive({ string: true, number: true, boolean: true }))
   })
 });
 export type ExecuteSqlRequest = t.Encoded<typeof ExecuteSqlRequest>;
@@ -20,7 +21,7 @@ export const ExecuteSqlResponse = t.object({
   success: t.boolean,
   results: t.object({
     columns: t.array(t.string),
-    rows: t.array(t.array(t.string.or(t.number).or(t.boolean).or(t.Null)))
+    rows: t.array(t.array(anyPrimitive({ string: true, number: true, boolean: true, null: true })))
   }),
   /** Set if success = false */
   error: t.string.optional()

package/test/codecs.test.ts

@@ -0,0 +1,77 @@
+import * as t from 'ts-codec';
+import { describe, expect, test } from 'vitest';
+
+import { anyPrimitive, enumLiteral, orNull } from '../src/codecs.js';
+
+test('orNull', () => {
+  const codec = orNull(t.literal('allowed'));
+
+  expect(codec.encode('allowed')).toStrictEqual('allowed');
+  expect(codec.decode('allowed')).toStrictEqual('allowed');
+  expect(codec.encode(null)).toStrictEqual(null);
+  expect(codec.decode(null)).toStrictEqual(null);
+
+  expect(() => codec.encode('invalid' as any)).throws();
+  expect(() => codec.decode('invalid' as any)).throws();
+});
+
+test('enumLiteral', () => {
+  const codec = enumLiteral('foo', 'bar', 'baz');
+
+  for (const value of ['foo', 'bar', 'baz'] as const) {
+    expect(codec.encode(value)).toStrictEqual(value);
+    expect(codec.decode(value)).toStrictEqual(value);
+  }
+
+  expect(() => codec.encode('invalid' as any)).throws();
+  expect(() => codec.decode('invalid' as any)).throws();
+});
+
+describe('anyPrimitive', () => {
+  test('allows only the configured types', () => {
+    const codec = anyPrimitive({ string: true, number: true }) as t.AnyCodec;
+
+    expect(codec.decode('foo')).toStrictEqual('foo');
+    expect(codec.decode(42)).toStrictEqual(42);
+    expect(codec.encode('foo')).toStrictEqual('foo');
+    expect(codec.encode(42)).toStrictEqual(42);
+
+    expect(() => codec.decode(true)).throws();
+    expect(() => codec.decode(null)).throws();
+    expect(() => codec.decode(undefined)).throws();
+    expect(() => codec.decode({})).throws();
+  });
+
+  test('allows null', () => {
+    const codec = anyPrimitive({ null: true }) as t.AnyCodec;
+
+    expect(codec.decode(null)).toStrictEqual(null);
+    expect(codec.encode(null)).toStrictEqual(null);
+
+    expect(() => codec.decode('foo')).throws();
+    expect(() => codec.decode(undefined)).throws();
+    expect(() => codec.decode({})).throws();
+  });
+
+  test('rejects types not in the configuration, even when other types are allowed', () => {
+    const codec = anyPrimitive({ boolean: true }) as t.AnyCodec;
+
+    expect(codec.decode(true)).toStrictEqual(true);
+    expect(codec.decode(false)).toStrictEqual(false);
+
+    expect(() => codec.decode('foo')).throws();
+    expect(() => codec.decode(1)).throws();
+    expect(() => codec.decode(null)).throws();
+    expect(() => codec.decode(undefined)).throws();
+  });
+
+  test('with no allowed types rejects everything', () => {
+    const codec = anyPrimitive({}) as any as t.AnyCodec;
+
+    expect(() => codec.decode('foo')).throws();
+    expect(() => codec.decode(1)).throws();
+    expect(() => codec.decode(true)).throws();
+    expect(() => codec.decode(null)).throws();
+    expect(() => codec.decode(undefined)).throws();
+  });
+});