@objectstack/spec 0.1.1 → 0.2.0

package/dist/api/contract.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.zod.d.ts","sourceRoot":"","sources":["../../src/api/contract.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAMH,eAAO,MAAM,gBAAgB,oCAA6D,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCxB,CAAC"}

package/dist/api/contract.zod.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiContracts = exports.DeleteResponseSchema = exports.BulkResponseSchema = exports.ModificationResultSchema = exports.ListRecordResponseSchema = exports.SingleRecordResponseSchema = exports.ExportRequestSchema = exports.BulkRequestSchema = exports.UpdateRequestSchema = exports.CreateRequestSchema = exports.RecordDataSchema = exports.BaseResponseSchema = exports.ApiErrorSchema = void 0;
+const zod_1 = require("zod");
+const query_zod_1 = require("../data/query.zod");
+// ==========================================
+// 1. Base Envelopes
+// ==========================================
+exports.ApiErrorSchema = zod_1.z.object({
+    code: zod_1.z.string().describe('Error code (e.g. validation_error)'),
+    message: zod_1.z.string().describe('Readable error message'),
+    details: zod_1.z.any().optional().describe('Additional error context (e.g. field validation errors)'),
+});
+exports.BaseResponseSchema = zod_1.z.object({
+    success: zod_1.z.boolean().describe('Operation success status'),
+    error: exports.ApiErrorSchema.optional().describe('Error details if success is false'),
+    meta: zod_1.z.object({
+        timestamp: zod_1.z.string(),
+        duration: zod_1.z.number().optional(),
+        requestId: zod_1.z.string().optional(),
+        traceId: zod_1.z.string().optional(),
+    }).optional().describe('Response metadata'),
+});
+// ==========================================
+// 2. Request Payloads (Inputs)
+// ==========================================
+exports.RecordDataSchema = zod_1.z.record(zod_1.z.any()).describe('Key-value map of record data');
+/**
+ * Standard Create Request
+ */
+exports.CreateRequestSchema = zod_1.z.object({
+    data: exports.RecordDataSchema.describe('Record data to insert'),
+});
+/**
+ * Standard Update Request
+ */
+exports.UpdateRequestSchema = zod_1.z.object({
+    data: exports.RecordDataSchema.describe('Partial record data to update'),
+});
+/**
+ * Standard Bulk Request
+ */
+exports.BulkRequestSchema = zod_1.z.object({
+    records: zod_1.z.array(exports.RecordDataSchema).describe('Array of records to process'),
+    allOrNone: zod_1.z.boolean().default(true).describe('If true, rollback entire transaction on any failure'),
+});
+/**
+ * Export Request
+ */
+exports.ExportRequestSchema = query_zod_1.QuerySchema.extend({
+    format: zod_1.z.enum(['csv', 'json', 'xlsx']).default('csv'),
+});
+// ==========================================
+// 3. Response Payloads (Outputs)
+// ==========================================
+/**
+ * Single Record Response (Get/Create/Update)
+ */
+exports.SingleRecordResponseSchema = exports.BaseResponseSchema.extend({
+    data: exports.RecordDataSchema.describe('The requested or modified record'),
+});
+/**
+ * List/Query Response
+ */
+exports.ListRecordResponseSchema = exports.BaseResponseSchema.extend({
+    data: zod_1.z.array(exports.RecordDataSchema).describe('Array of matching records'),
+    pagination: zod_1.z.object({
+        total: zod_1.z.number().describe('Total matching records count'),
+        limit: zod_1.z.number().describe('Page size'),
+        offset: zod_1.z.number().describe('Page offset'),
+        hasMore: zod_1.z.boolean().describe('Are there more pages?'),
+    }).describe('Pagination info'),
+});
+/**
+ * Modification Result (for Batch/Bulk operations)
+ */
+exports.ModificationResultSchema = zod_1.z.object({
+    id: zod_1.z.string().optional().describe('Record ID if processed'),
+    success: zod_1.z.boolean(),
+    errors: zod_1.z.array(exports.ApiErrorSchema).optional(),
+});
+/**
+ * Bulk Operation Response
+ */
+exports.BulkResponseSchema = exports.BaseResponseSchema.extend({
+    data: zod_1.z.array(exports.ModificationResultSchema).describe('Results for each item in the batch'),
+});
+/**
+ * Delete Response
+ */
+exports.DeleteResponseSchema = exports.BaseResponseSchema.extend({
+    id: zod_1.z.string().describe('ID of the deleted record'),
+});
+// ==========================================
+// 4. API Contract Registry
+// ==========================================
+/**
+ * Standard API Contracts map
+ * Used for generating SDKs and Documentation
+ */
+exports.ApiContracts = {
+    create: {
+        input: exports.CreateRequestSchema,
+        output: exports.SingleRecordResponseSchema
+    },
+    update: {
+        input: exports.UpdateRequestSchema,
+        output: exports.SingleRecordResponseSchema
+    },
+    delete: {
+        input: zod_1.z.object({}), // usually just ID in URL
+        output: exports.DeleteResponseSchema
+    },
+    get: {
+        input: zod_1.z.object({}), // usually just ID in URL
+        output: exports.SingleRecordResponseSchema
+    },
+    list: {
+        input: query_zod_1.QuerySchema,
+        output: exports.ListRecordResponseSchema
+    },
+    bulkCreate: {
+        input: exports.BulkRequestSchema,
+        output: exports.BulkResponseSchema
+    },
+    bulkUpdate: {
+        input: exports.BulkRequestSchema,
+        output: exports.BulkResponseSchema
+    },
+    bulkUpsert: {
+        input: exports.BulkRequestSchema,
+        output: exports.BulkResponseSchema
+    },
+    bulkDelete: {
+        input: zod_1.z.object({ ids: zod_1.z.array(zod_1.z.string()) }),
+        output: exports.BulkResponseSchema
+    }
+};

package/dist/data/dataset.zod.d.ts

@@ -45,14 +45,14 @@ export declare const DatasetSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     object: string;
     externalId: string;
-    mode: "insert" | "update" | "upsert" | "replace" | "ignore";
+    mode: "update" | "upsert" | "insert" | "replace" | "ignore";
     env: ("prod" | "dev" | "test")[];
     records: Record<string, any>[];
 }, {
     object: string;
     records: Record<string, any>[];
     externalId?: string | undefined;
-    mode?: "insert" | "update" | "upsert" | "replace" | "ignore" | undefined;
+    mode?: "update" | "upsert" | "insert" | "replace" | "ignore" | undefined;
     env?: ("prod" | "dev" | "test")[] | undefined;
 }>;
 export type Dataset = z.infer<typeof DatasetSchema>;