@kubun/graphql 0.13.0 → 0.14.0

package/lib/identifiers.d.ts

@@ -1,3 +1,4 @@
 import { GraphQLScalarType } from 'graphql';
 export declare const GraphQLAttachmentID: GraphQLScalarType<string, string>;
+export declare const GraphQLCredentialEntryID: GraphQLScalarType<string, string>;
 export declare const GraphQLDocID: GraphQLScalarType<string, string>;

package/lib/identifiers.js

@@ -1,4 +1,4 @@
-import { AttachmentID, DocumentID } from '@kubun/id';
+import { AttachmentID, CredentialEntryID, DocumentID } from '@kubun/id';
 import { GraphQLError, GraphQLScalarType, Kind } from 'graphql';
 function validateAttachmentID(input) {
     if (typeof input !== 'string') {
@@ -20,6 +20,28 @@ export const GraphQLAttachmentID = new GraphQLScalarType({
         return validateAttachmentID(ast.value);
     }
 });
+function validateCredentialEntryID(input) {
+    if (typeof input !== 'string') {
+        throw new GraphQLError(`Invalid CredentialEntryID input: ${input}`);
+    }
+    // The whole check. Every Kubun id matches the scalar's pattern, so a document
+    // id or a credential KEY id would otherwise reach a resolver that expects an
+    // entry and miss with a message about absence rather than about type.
+    CredentialEntryID.fromString(input);
+    return input;
+}
+export const GraphQLCredentialEntryID = new GraphQLScalarType({
+    name: 'CredentialEntryID',
+    description: 'A Kubun Credential Entry identifier',
+    serialize: validateCredentialEntryID,
+    parseValue: validateCredentialEntryID,
+    parseLiteral (ast) {
+        if (ast.kind !== Kind.STRING) {
+            throw new GraphQLError(`Can only validate strings as CredentialEntryID but got a: ${ast.kind}`);
+        }
+        return validateCredentialEntryID(ast.value);
+    }
+});
 function validateDocID(input) {
     if (typeof input !== 'string') {
         throw new GraphQLError(`Invalid DocumentID input: ${input}`);

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 export type { AccessWarning, AggregateScope, ComplexityStats, Context, CreateMutationParams, DocumentEventEmitter, DocumentSavedEvent, MutationContext, PluginContextMap, QueryContext, ReadContextDB, ReadContextParams, ReadOnlyContext, RemoveMutationParams, ScopedConnection, SetDocumentAccessOverrideParams, SetModelAccessDefaultsParams, SetMutationParams, SubscriptionContext, UpdateMutationParams, } from './context.js';
 export { createReadContext } from './context.js';
-export { GraphQLAttachmentID, GraphQLDocID } from './identifiers.js';
+export { GraphQLAttachmentID, GraphQLCredentialEntryID, GraphQLDocID, } from './identifiers.js';
 export type { ExtensionResolvers, SchemaBuilderParams, SharedDefinitions, } from './schema.js';
 export { createSchema, SchemaBuilder } from './schema.js';
 export type * from './types.js';

package/lib/index.js

@@ -4,5 +4,5 @@
 // list silently breaks resolver typing (`TS2339: Property '<name>' does not
 // exist on type 'Context'`).
 export { createReadContext } from './context.js';
-export { GraphQLAttachmentID, GraphQLDocID } from './identifiers.js';
+export { GraphQLAttachmentID, GraphQLCredentialEntryID, GraphQLDocID } from './identifiers.js';
 export { createSchema, SchemaBuilder } from './schema.js';

package/lib/schema.d.ts

@@ -194,6 +194,7 @@ export declare class SchemaBuilder {
     _buildArray(schema: ArrayModel, parentName?: string): GraphQLList<GraphQLNonNull<GraphQLOutputType>>;
     _buildObject(id: string, schema: ObjectModel, parentName?: string): GraphQLObjectType;
     _buildObjectFields(id: string, schema: DocumentModelSchema | ObjectModel, parentName?: string): GraphQLFieldConfigMap<Record<string, unknown>, Context>;
+    _buildNestedAttachmentField(key: string, fieldRef: string): GraphQLFieldConfig<Record<string, unknown>, Context> | null;
     _buildRelationFields(fields: GraphQLFieldConfigMap<DocumentNode, Context>, fieldName: string, relation: RelationField): void;
     _buildRelationSubscriptions(fields: GraphQLFieldConfigMap<unknown, Context>, modelID: string, fieldName: string, relation: RelationField): void;
     _buildString(schema: StringModel, parentName: string): GraphQLEnumType | GraphQLObjectType | GraphQLScalarType;

package/lib/schema.js

@@ -4,7 +4,7 @@ import { pascalCase } from 'change-case';
 import { extendSchema, GraphQLBoolean, GraphQLEnumType, GraphQLFloat, GraphQLID, GraphQLInputObjectType, GraphQLInt, GraphQLInterfaceType, GraphQLList, GraphQLNonNull, GraphQLObjectType, GraphQLSchema, GraphQLString, isEnumType, isListType, isNonNullType, isObjectType, isScalarType, Kind, parse as parseGraphQL } from 'graphql';
 import { connectionArgs, connectionDefinitions, mutationWithClientMutationId, nodeDefinitions } from 'graphql-relay';
 import { GraphQLDateTimeISO, GraphQLDID, GraphQLDuration, GraphQLEmailAddress, GraphQLJSON, GraphQLJSONObject } from 'graphql-scalars';
-import { GraphQLAttachmentID, GraphQLDocID } from './identifiers.js';
+import { GraphQLAttachmentID, GraphQLCredentialEntryID, GraphQLDocID } from './identifiers.js';
 import { GraphQLURL } from './scalars.js';
 import { getUniqueDocValue, validateAccessIdentifiers } from './utils.js';
 /**
@@ -44,9 +44,13 @@ const STRING_FORMATS = {
 };
 const STRING_TITLES = {
     attachmentid: GraphQLAttachmentID,
+    credentialentryid: GraphQLCredentialEntryID,
     did: GraphQLDID,
     docid: GraphQLDocID
 };
+function isAttachmentIDString(schema) {
+    return schema.type === 'string' && schema.title?.toLowerCase() === 'attachmentid';
+}
 function getReferenceID(path) {
     return path.slice(REFERENCE_PREFIX.length);
 }
@@ -854,12 +858,13 @@ export class SchemaBuilder {
                 fields: queryFields
             }),
             // Ensure custom scalars stay reachable from the schema typeMap so plugin
-            // SDL extensions can reference them by name (URL, DID, DateTimeISO)
+            // SDL extensions can reference them by name (URL, DID, DateTimeISO, JSON)
             // regardless of whether any model field happens to use them.
             types: [
                 GraphQLURL,
                 GraphQLDID,
-                GraphQLDateTimeISO
+                GraphQLDateTimeISO,
+                GraphQLJSON
             ]
         };
         if (this._includeMutations) {
@@ -2439,6 +2444,11 @@ export class SchemaBuilder {
             if (fieldRef == null) {
                 throw new Error(`Missing ref for field ${key} of object ${id}`);
             }
+            const attachmentField = this._buildNestedAttachmentField(key, fieldRef);
+            if (attachmentField != null) {
+                fields[key] = attachmentField;
+                continue;
+            }
             const type = this._getReference(fieldRef, parentName);
             fields[key] = {
                 type: required.includes(key) ? new GraphQLNonNull(type) : type
@@ -2446,6 +2456,24 @@ export class SchemaBuilder {
         }
         return fields;
     }
+    // An attachmentid leaf nested inside an object is exposed as the AttachmentNode
+    // object rather than a bare AttachmentID scalar, so state/mimeType/contentLength
+    // resolve — mirroring the top-level attachment convenience fields. Always
+    // nullable (like the top-level fields): the value may be absent, e.g. an
+    // attachment not yet imported. Returns null for non-attachment fields.
+    _buildNestedAttachmentField(key, fieldRef) {
+        const refSchema = this._getReferenceSchema(getReferenceID(fieldRef));
+        if (!isAttachmentIDString(refSchema)) {
+            return null;
+        }
+        return {
+            type: this._getDefinitions().attachmentObject,
+            resolve: (source)=>{
+                const value = source[key];
+                return value ? AttachmentID.fromString(value) : null;
+            }
+        };
+    }
     _buildRelationFields(fields, fieldName, relation) {
         if (relation.isList) {
             // DB does not support matches for array containing values

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/graphql",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -15,6 +15,10 @@
     "LICENSE.md"
   ],
   "dependencies": {
+    "@kubun/hlc": "^0.14.0",
+    "@kubun/id": "^0.14.0",
+    "@kubun/logger": "^0.14.0",
+    "@kubun/protocol": "^0.14.0",
     "@sozai/async": "^0.2.1",
     "@sozai/codec": "^0.4.0",
     "@sozai/event": "^0.1.3",
@@ -22,20 +26,17 @@
     "change-case": "^5.4.4",
     "graphql": "^16.14.2",
     "graphql-relay": "^0.10.2",
-    "graphql-scalars": "^1.26.0",
-    "multiformats": "^14.0.5",
-    "@kubun/logger": "^0.12.0",
-    "@kubun/hlc": "^0.12.0",
-    "@kubun/id": "^0.12.0",
-    "@kubun/protocol": "^0.13.0"
+    "graphql-scalars": "^2.0.0",
+    "multiformats": "^14.0.5"
   },
   "devDependencies": {
-    "@kokuin/capability": "^0.2.2",
-    "@kokuin/token": "^0.4.0",
-    "@kubun/store-graph": "^0.13.0",
-    "@kubun/db-better-sqlite": "^0.12.1",
-    "@kubun/db": "^0.12.1",
-    "@kubun/test-utils": "^0.12.0"
+    "@kokuin/capability": "^0.3.0",
+    "@kokuin/token": "^0.5.0",
+    "@kubun/db": "^0.14.0",
+    "@kubun/db-better-sqlite": "^0.14.0",
+    "@kubun/scalars": "^0.14.0",
+    "@kubun/store-graph": "^0.14.0",
+    "@kubun/test-utils": "^0.13.0"
   },
   "publishConfig": {
     "access": "public"