firestore-schema-kit 1.0.0 → 2.1.0

package/dist/collection.d.ts

@@ -0,0 +1,24 @@
+import { type ZodError, type ZodIssue } from 'zod';
+import { type FieldShape, type InferFields, type SchemaBuilder } from './fields.js';
+export declare class SchemaValidationError extends Error {
+    readonly collection: string;
+    readonly issues: ZodIssue[];
+    constructor(collectionName: string, zodError: ZodError);
+}
+export type CollectionSafeParseResult<TData extends Record<string, unknown>> = {
+    success: true;
+    data: TData;
+} | {
+    success: false;
+    error: SchemaValidationError;
+};
+export interface CollectionSchema<TData extends Record<string, unknown>, TShape extends FieldShape = FieldShape> {
+    _name: string;
+    _fieldDefs: TShape;
+    _type: 'CollectionSchema';
+    validate: (data: unknown) => TData;
+    validatePartial: (data: unknown) => Partial<TData>;
+    safeParse: (data: unknown) => CollectionSafeParseResult<TData>;
+}
+export declare function defineCollection<const TShape extends FieldShape>(collectionName: string, builder: (s: SchemaBuilder) => TShape): CollectionSchema<InferFields<TShape>, TShape>;
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAA;AACrD,OAAO,EAAK,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAEtF,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,MAAM,EAAE,QAAQ,EAAE,CAAA;gBAEtB,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAUvD;AAED,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACvE;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GAC9B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAEpD,MAAM,WAAW,gBAAgB,CAC/B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,SAAS,UAAU,GAAG,UAAU;IAEtC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,kBAAkB,CAAA;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,CAAA;IAClC,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;IAClD,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,yBAAyB,CAAC,KAAK,CAAC,CAAA;CAC/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,MAAM,SAAS,UAAU,EAC9D,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,MAAM,GACpC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAqD/C"}

package/dist/collection.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { s } from './fields.js';
+export class SchemaValidationError extends Error {
+    collection;
+    issues;
+    constructor(collectionName, zodError) {
+        const issues = zodError.issues
+            .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+            .join('\n');
+        super(`[${collectionName}] Schema validation failed:\n${issues}`);
+        this.name = 'SchemaValidationError';
+        this.collection = collectionName;
+        this.issues = zodError.issues;
+    }
+}
+export function defineCollection(collectionName, builder) {
+    if (typeof collectionName !== 'string' || !collectionName.trim()) {
+        throw new Error('defineCollection: collectionName must be a non-empty string');
+    }
+    if (typeof builder !== 'function') {
+        throw new Error('defineCollection: builder must be a function');
+    }
+    const fieldDefs = builder(s);
+    if (!fieldDefs || typeof fieldDefs !== 'object') {
+        throw new Error('defineCollection: builder must return an object of field definitions');
+    }
+    const zodShape = {};
+    for (const [key, field] of Object.entries(fieldDefs)) {
+        if (!field || typeof field !== 'object' || typeof field.toZod !== 'function') {
+            throw new Error(`defineCollection [${collectionName}]: field "${key}" is not a valid schema field. ` +
+                'Use s.string(), s.number(), etc.');
+        }
+        zodShape[key] = field.toZod();
+    }
+    const zodSchema = z.object(zodShape);
+    const zodPartialSchema = zodSchema.partial();
+    return {
+        _name: collectionName,
+        _fieldDefs: fieldDefs,
+        _type: 'CollectionSchema',
+        validate(data) {
+            const result = zodSchema.safeParse(data);
+            if (!result.success)
+                throw new SchemaValidationError(collectionName, result.error);
+            return result.data;
+        },
+        validatePartial(data) {
+            const result = zodPartialSchema.safeParse(data);
+            if (!result.success)
+                throw new SchemaValidationError(collectionName, result.error);
+            return result.data;
+        },
+        safeParse(data) {
+            const result = zodSchema.safeParse(data);
+            if (!result.success) {
+                return { success: false, error: new SchemaValidationError(collectionName, result.error) };
+            }
+            return { success: true, data: result.data };
+        },
+    };
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/fields.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import type { DocumentReference, FieldValue, Timestamp } from 'firebase/firestore';
+export declare const fieldOutputSymbol: unique symbol;
+export type FieldOutput<TField extends BaseField<any>> = TField[typeof fieldOutputSymbol];
+export type FieldShape = Record<string, BaseField<any>>;
+export type InferFields<TShape extends FieldShape> = {
+    [K in keyof TShape]: FieldOutput<TShape[K]>;
+};
+type LiteralValue = string | number | bigint | boolean | null | undefined;
+export type TimestampLike = Date | Timestamp | FieldValue;
+export declare abstract class BaseField<TOutput = unknown> {
+    readonly [fieldOutputSymbol]: TOutput;
+    protected _optional: boolean;
+    protected _nullable: boolean;
+    protected _hasDefault: boolean;
+    protected _defaultVal: unknown;
+    optional(): this & BaseField<TOutput | undefined>;
+    nullable(): this & BaseField<TOutput | null>;
+    default<TValue>(val: TValue): this & BaseField<Exclude<TOutput, undefined>>;
+    protected abstract _baseZod(): z.ZodTypeAny;
+    toZod(): z.ZodType<TOutput>;
+}
+export declare class StringField extends BaseField<string> {
+    private _min;
+    private _max;
+    private _email;
+    private _url;
+    private _uuid;
+    private _regex;
+    min(n: number): this;
+    max(n: number): this;
+    email(): this;
+    url(): this;
+    uuid(): this;
+    regex(r: RegExp): this;
+    protected _baseZod(): z.ZodString;
+}
+export declare class NumberField extends BaseField<number> {
+    private _min;
+    private _max;
+    private _int;
+    private _positive;
+    private _negative;
+    min(n: number): this;
+    max(n: number): this;
+    int(): this;
+    positive(): this;
+    negative(): this;
+    protected _baseZod(): z.ZodNumber;
+}
+export declare class BooleanField extends BaseField<boolean> {
+    protected _baseZod(): z.ZodBoolean;
+}
+export declare class TimestampField extends BaseField<TimestampLike> {
+    protected _baseZod(): z.ZodType<TimestampLike>;
+}
+export declare class ArrayField<TItemField extends BaseField<any>> extends BaseField<Array<FieldOutput<TItemField>>> {
+    private readonly _itemField;
+    private _min;
+    private _max;
+    constructor(itemField: TItemField);
+    min(n: number): this;
+    max(n: number): this;
+    protected _baseZod(): z.ZodType<Array<FieldOutput<TItemField>>>;
+}
+export declare class MapField<TShape extends FieldShape> extends BaseField<InferFields<TShape>> {
+    private readonly _shape;
+    constructor(shape: TShape);
+    protected _baseZod(): z.ZodType<InferFields<TShape>>;
+}
+export declare class EnumField<TValues extends readonly [string, ...string[]]> extends BaseField<TValues[number]> {
+    private readonly _values;
+    constructor(values: TValues);
+    protected _baseZod(): z.ZodType<TValues[number]>;
+}
+export declare class LiteralField<TValue extends LiteralValue> extends BaseField<TValue> {
+    private readonly _value;
+    constructor(value: TValue);
+    protected _baseZod(): z.ZodLiteral<TValue>;
+}
+export declare class ReferenceField extends BaseField<DocumentReference> {
+    protected _baseZod(): z.ZodType<DocumentReference>;
+}
+export declare class UnionField<TFields extends readonly [BaseField<any>, ...BaseField<any>[]]> extends BaseField<FieldOutput<TFields[number]>> {
+    private readonly _fields;
+    constructor(fields: TFields);
+    protected _baseZod(): z.ZodType<FieldOutput<TFields[number]>>;
+}
+export declare class AnyField extends BaseField<any> {
+    protected _baseZod(): z.ZodAny;
+}
+export interface SchemaBuilder {
+    string: () => StringField;
+    number: () => NumberField;
+    boolean: () => BooleanField;
+    timestamp: () => TimestampField;
+    array: <TItemField extends BaseField<any>>(itemField: TItemField) => ArrayField<TItemField>;
+    map: <TShape extends FieldShape>(shape: TShape) => MapField<TShape>;
+    enum: <const TValues extends readonly [string, ...string[]]>(values: TValues) => EnumField<TValues>;
+    literal: <TValue extends LiteralValue>(value: TValue) => LiteralField<TValue>;
+    reference: () => ReferenceField;
+    union: <TFields extends readonly [BaseField<any>, ...BaseField<any>[]]>(fields: TFields) => UnionField<TFields>;
+    any: () => AnyField;
+}
+export declare const s: SchemaBuilder;
+export {};
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

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

package/dist/fields.js

@@ -0,0 +1,242 @@
+import { z } from 'zod';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasToDate(value) {
+    return isRecord(value) && typeof value.toDate === 'function';
+}
+function isServerTimestampSentinel(value) {
+    return isRecord(value) && '_methodName' in value;
+}
+export class BaseField {
+    _optional = false;
+    _nullable = false;
+    _hasDefault = false;
+    _defaultVal = undefined;
+    optional() {
+        this._optional = true;
+        return this;
+    }
+    nullable() {
+        this._nullable = true;
+        return this;
+    }
+    default(val) {
+        this._hasDefault = true;
+        this._defaultVal = val;
+        return this;
+    }
+    toZod() {
+        let schema = this._baseZod();
+        if (this._nullable)
+            schema = schema.nullable();
+        if (this._hasDefault)
+            schema = schema.default(this._defaultVal);
+        if (this._optional)
+            schema = schema.optional();
+        return schema;
+    }
+}
+export class StringField extends BaseField {
+    _min = null;
+    _max = null;
+    _email = false;
+    _url = false;
+    _uuid = false;
+    _regex = null;
+    min(n) {
+        this._min = n;
+        return this;
+    }
+    max(n) {
+        this._max = n;
+        return this;
+    }
+    email() {
+        this._email = true;
+        return this;
+    }
+    url() {
+        this._url = true;
+        return this;
+    }
+    uuid() {
+        this._uuid = true;
+        return this;
+    }
+    regex(r) {
+        this._regex = r;
+        return this;
+    }
+    _baseZod() {
+        let schema = z.string();
+        if (this._min !== null)
+            schema = schema.min(this._min);
+        if (this._max !== null)
+            schema = schema.max(this._max);
+        if (this._email)
+            schema = schema.email();
+        if (this._url)
+            schema = schema.url();
+        if (this._uuid)
+            schema = schema.uuid();
+        if (this._regex !== null)
+            schema = schema.regex(this._regex);
+        return schema;
+    }
+}
+export class NumberField extends BaseField {
+    _min = null;
+    _max = null;
+    _int = false;
+    _positive = false;
+    _negative = false;
+    min(n) {
+        this._min = n;
+        return this;
+    }
+    max(n) {
+        this._max = n;
+        return this;
+    }
+    int() {
+        this._int = true;
+        return this;
+    }
+    positive() {
+        this._positive = true;
+        return this;
+    }
+    negative() {
+        this._negative = true;
+        return this;
+    }
+    _baseZod() {
+        let schema = this._int ? z.number().int() : z.number();
+        if (this._min !== null)
+            schema = schema.min(this._min);
+        if (this._max !== null)
+            schema = schema.max(this._max);
+        if (this._positive)
+            schema = schema.positive();
+        if (this._negative)
+            schema = schema.negative();
+        return schema;
+    }
+}
+export class BooleanField extends BaseField {
+    _baseZod() {
+        return z.boolean();
+    }
+}
+export class TimestampField extends BaseField {
+    _baseZod() {
+        return z.custom((val) => {
+            if (!val)
+                return false;
+            if (val instanceof Date)
+                return true;
+            if (hasToDate(val))
+                return true;
+            if (isServerTimestampSentinel(val))
+                return true;
+            return false;
+        }, { message: 'Expected a Date, Firestore Timestamp, or serverTimestamp()' });
+    }
+}
+export class ArrayField extends BaseField {
+    _itemField;
+    _min = null;
+    _max = null;
+    constructor(itemField) {
+        super();
+        this._itemField = itemField;
+    }
+    min(n) {
+        this._min = n;
+        return this;
+    }
+    max(n) {
+        this._max = n;
+        return this;
+    }
+    _baseZod() {
+        let schema = z.array(this._itemField.toZod());
+        if (this._min !== null)
+            schema = schema.min(this._min);
+        if (this._max !== null)
+            schema = schema.max(this._max);
+        return schema;
+    }
+}
+export class MapField extends BaseField {
+    _shape;
+    constructor(shape) {
+        super();
+        this._shape = shape;
+    }
+    _baseZod() {
+        const zodShape = {};
+        for (const [key, field] of Object.entries(this._shape)) {
+            zodShape[key] = field.toZod();
+        }
+        return z.object(zodShape);
+    }
+}
+export class EnumField extends BaseField {
+    _values;
+    constructor(values) {
+        super();
+        this._values = values;
+    }
+    _baseZod() {
+        return z.enum(this._values);
+    }
+}
+export class LiteralField extends BaseField {
+    _value;
+    constructor(value) {
+        super();
+        this._value = value;
+    }
+    _baseZod() {
+        return z.literal(this._value);
+    }
+}
+export class ReferenceField extends BaseField {
+    _baseZod() {
+        return z.custom((val) => isRecord(val) &&
+            typeof val.path === 'string' &&
+            typeof val.id === 'string', { message: 'Expected a Firestore DocumentReference' });
+    }
+}
+export class UnionField extends BaseField {
+    _fields;
+    constructor(fields) {
+        super();
+        this._fields = fields;
+    }
+    _baseZod() {
+        const schemas = this._fields.map((field) => field.toZod());
+        return z.union(schemas);
+    }
+}
+export class AnyField extends BaseField {
+    _baseZod() {
+        return z.any();
+    }
+}
+export const s = {
+    string: () => new StringField(),
+    number: () => new NumberField(),
+    boolean: () => new BooleanField(),
+    timestamp: () => new TimestampField(),
+    array: (itemField) => new ArrayField(itemField),
+    map: (shape) => new MapField(shape),
+    enum: (values) => new EnumField(values),
+    literal: (value) => new LiteralField(value),
+    reference: () => new ReferenceField(),
+    union: (fields) => new UnionField(fields),
+    any: () => new AnyField(),
+};
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { s } from './fields.js';
+export { defineCollection, SchemaValidationError } from './collection.js';
+export { initFirestoreSchema } from './operations.js';
+export type { BaseField, FieldOutput, FieldShape, InferFields, SchemaBuilder, TimestampLike, } from './fields.js';
+export type { CollectionSafeParseResult, CollectionSchema, } from './collection.js';
+export type { FirestoreSchemaOperations, SchemaBatch, SchemaTransaction, WithId, } from './operations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { s } from './fields.js';
+export { defineCollection, SchemaValidationError } from './collection.js';
+export { initFirestoreSchema } from './operations.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/operations.d.ts

@@ -0,0 +1,34 @@
+import type { CollectionReference, DocumentData, DocumentReference, Firestore, QueryConstraint, SetOptions, Unsubscribe } from 'firebase/firestore';
+import type { CollectionSchema } from './collection.js';
+export type WithId<TData extends DocumentData> = TData & {
+    id: string;
+};
+export interface SchemaBatch {
+    create: <TData extends DocumentData>(schema: CollectionSchema<TData>, data: TData) => DocumentReference<TData>;
+    set: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: TData | Partial<TData>, options?: SetOptions) => SchemaBatch;
+    update: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: Partial<TData>) => SchemaBatch;
+    delete: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference) => SchemaBatch;
+    commit: () => Promise<void>;
+}
+export interface SchemaTransaction {
+    get: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference) => Promise<WithId<TData> | null>;
+    set: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: TData | Partial<TData>, options?: SetOptions) => SchemaTransaction;
+    update: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: Partial<TData>) => SchemaTransaction;
+    delete: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference) => SchemaTransaction;
+}
+export interface FirestoreSchemaOperations {
+    createDoc: <TData extends DocumentData>(schema: CollectionSchema<TData>, data: TData) => Promise<DocumentReference<TData>>;
+    setDoc: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: TData | Partial<TData>, options?: SetOptions) => Promise<void>;
+    updateDoc: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, data: Partial<TData>) => Promise<void>;
+    deleteDoc: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference) => Promise<void>;
+    getDoc: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference) => Promise<WithId<TData> | null>;
+    getDocs: <TData extends DocumentData>(schema: CollectionSchema<TData>, ...constraints: QueryConstraint[]) => Promise<Array<WithId<TData>>>;
+    getDocRef: <TData extends DocumentData>(schema: CollectionSchema<TData>, id: string) => DocumentReference<TData>;
+    getCollectionRef: <TData extends DocumentData>(schema: CollectionSchema<TData>) => CollectionReference<TData>;
+    onDocSnapshot: <TData extends DocumentData>(schema: CollectionSchema<TData>, idOrRef: string | DocumentReference, callback: (data: WithId<TData> | null) => void, onError?: (error: Error) => void) => Unsubscribe;
+    onCollectionSnapshot: <TData extends DocumentData>(schema: CollectionSchema<TData>, callback: (docs: Array<WithId<TData>>) => void, ...constraints: QueryConstraint[]) => Unsubscribe;
+    createBatch: () => SchemaBatch;
+    runTransaction: <TResult>(updateFn: (t: SchemaTransaction) => Promise<TResult>) => Promise<TResult>;
+}
+export declare function initFirestoreSchema(db: Firestore): FirestoreSchemaOperations;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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